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PREFACE 


This publication describes the TESTRAN 
facility for testing programs written in 
the assembler language. It introduces this 


facility in Section 1, which shows by an 
example how TESTRAN helps in testing a 
program, and shows how the reader can use 


TESTRAN in testing his own programs. 


Sections 2, 3, and 4 guide the reader in 
writing a source program, in writing job 


control statements, and in interpreting 
test results. The reader need not go 
beyond Section 2 before completing his 
source coding, and need not go _ beyond 
Section 3 before actually testing his pro- 
gram under the operating system. Also, he 
need not read any section in its’ entirety, 


because each treats a number of independent 
topics that can be referred to directly 
from the table of contents. 


Several appendixes provide detailed 
descriptions of source statements, cata- 
loged procedures, and diagnostic messages. 
Appendix A is of special interest, because 
it formally describes statements that are 
informally described in Section 2. The 
reader can use either Appendix A or Section 
2 as the model for his own coding, depend- 
ing on the style of presentation he 
prefers. 


PREREQUISITE PUBLICATIONS 


The following 
prerequisites: 


publications are 


IBM System/360 Operating System: 
Introduction, Form C28-6534 


Concepts and Facilities, Form C28-6535 


Assembler Language, Form C28-6514 


Knowledge of the macro-language, as 
described in the Assembler Language publi- 
cation, is not required. However, the 
reader should know the general functions of 
system-defined macro-instructions (SAVE, 
OPEN, GET, PUT, DCB) that are introduced in 
the Concepts and Facilities publication and 
are fully described in the publications: 


IBM System/360 Operating System: 


Supervisor and Data Management Services, 
Form C28-6646 


Supervisor and Data Management Macro 
Instructions, C28-6647 


PUBLICATIONS TO WHICH THE TEXT REFERS 


The foilowing publications are referred 
to in this publication, but are not neces- 
sarily prerequisites: 


IBM System/360 Operating System: 


Assembler (E) Programmer's Guide, 
C28-6595 


Assembler _(F) Programmer's Guide, Form 
C26-3756 


Form 


Linkage Editor, Form C28-6538 


Job Control Language, Form C28-6539 
Utilities, Form C28-6586 


Messages and Codes, Form C28-6631 


Programmer's Guide to Debugging, Form 


C28-6670 
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SECTION 1: INTRODUCTION 


The testing of a major program can be as time-consuming as the design 
and coding of its routines. Although testing is always time well spent, 
the need to meet deadlines often leads to incomplete testing and 
subsequent failures. And a failure in a single control section can 
delay an entire project. 


To help in testing programs, the IBM System/360 Operating System 
offers a facility known as the test translator, or MTESTRAN. This 
facility helps to uncover faulty logic by providing printed information 
about the actual working of a program. At the programmer's direction, 
TESTRAN describes the changing contents of storage areas, registers, and 
control blocks, and also the way in which control flows from one group 
of instructions to another. 


- AS an example, the test of a subroutine named PRIMER is shown in 
Figure i. For any positive number X, PRIMER is designed to find the 
smallest number greater than X that is a prime number. The TESTRAN 
listing shows that PRIMER contains an error, because, as shown at (1) in 

the figure, it returns a result of 3 rather than 2 for K = 1. 


From the TESTRAN listing, the programmer can reconstruct the flow of 
data and control that occurred during execution of PRIMER. As shown at 
(2), the value X = 1 was loaded into general register 10 before 
execution of the instruction assembled at 000064. Branches were made to 
ODD and GOT. The erroneous result +3 was stored from general register 
11 before execution of the RETURN macro-instruction assembled at 0000CO0. 


Tracing the flow of control, it is easy to find the instructions that 
caused the error. Because X was an odd value, it was moved to register 
11 and, at (3), increased by two. The resuit, being a prime number, was 
stored as the answer. The error is obviously based on the assumpticn 
that, if X is an odd number, the next larger prime number must also be 
an odd number. In the single case X = 1, the assumption is invalid. 


The error in PRIMER is simple enough that it might easily be 
recognized even without the help of TESTRAN. From this example, 
however, it should be clear that TESTRAN could be most helpful in 
finding hidden and complicated errors. In addition, one should remember 
-that even so trivial an error could be difficult to find if the 
subroutine were part of a large, complex program. 


A TESTRAN listing, such as that shown in Figure 1, is printed after 
execution of the program being tested. During execution, TESTRAN can 
provide an additional service by checking for predefined error condi- 
tions and taking corrective actions when necessary. For example, the 
programmer might know that some value in his program should never exceed 
a certain maximum. The value might ke a result computead by a 
subroutine, or it could be a counter used to control a processing loop. 
TESTRAN could be used to check the value and, if the maximum were 
exceeded, to substitute a lesser vaiue or to pass control to some other 
part of the program. Of course, the final results of the program would 
probably be incorrect, but the continued processing would offer the 
chance of finding other errors not related tos the faulty loop or 
subroutine. 


TESTRAN LISTING 






LMA 7 BT 


) TESTING TESTRAN OUTPUT DATE 66/084 TIME 00/00 PAGE 5 te ga ee 


1) MACRO ID 003, DUMP CHANGES 


LOC OBJECT CODE ADDRI ADDR2 STMT SOURCE S 


000058 150 |PRIMER 
000058 151 


NONE 


1) MACRO ID 002, TRACE FLOW , TTPRIME , FROM CPRIMER ) 000064 005784, CC=0 
vc 26 G 


Cc 
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00 
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BC 20 F 060 


made to GOT 000090 1C45 
from relative 000092 195B 


location 000094. 






1) MACRO ID 002, TRACE FLOW , TTPRIME , FROM CPRIMER ) 0000C0O 0057E0, CC=2 
VC 26 G'00' 0000003C G'01' 8000581C G'14' 4000582A G'15' 00005778 


S 









A result of +3 
was stored from 





aN » x QONNG 11! 43h general register aA 
5 = 11(G'IT'), 

PSW FF 5 0026 6 0 OOS7E2 CC=2 FIX POINT OVERFLOW OFF DEC OVERFLOW OFF EXP UNDERFLOW OFF SIGNIFICANCE OFF DER RQ Qua ; 
: | C0000CO RN BAY 
AT LOCATION TTSVC2 CCALLTEST) OOQOOOEA 00582A ENTER DATAGEN 189 ERR F 
. 0000D8 : 194 L 

0000D8 0001 195 

1) MACRO ID 010 DUMP DATA STARTING IN SECTION CALLTEST OOO0O0DA 0002 196 
000058 197 E 





AT LOCATION CPRIMER ) 000058 005778 ENTER TTPRIME Ne 


TESTRAN LISTING 





ASSEMBLY LISTING 


AN OUTPUT DATE 66/084 TIME 00/00 PAGE 5 


LOC OBJECT CODE ADDR1 ADDR2 STMT} SOURCE STATEMENT E O1FEB66 3/30/66 


IE , FROM CPRIMER ) 000064 005784, CC 000058 150 |PRIMER CSECT 


=0 
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general register 
X POINT OVERFLOW OFF DEC OVERFLOW OFF EXP UNDERFLOW OFF SIGNIFICANCE OFF HW (Gt1T). 





RC= 
00582A ENTER DATAGEN 9 TU ¢ 2,RC=0 E 
0000D8 4 LTORG 
0000D8 0001 195 =H'1! 
IN SECTION CALLTEST O000DA 0002 196 H'2? 
000058 197 END 


ENTER TTPRIME 





Figure 1. Use of TESTRAN to Detect an Error in a Program 
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TESTING PROCEDURE 


Requests for TESTRAN services are coded in a TESTRAN source module. 
This module is combined with the program to be tested (the problem 
program) either by the assembler or by the linkage editor, as shown in 
Figure 2. In the first case, the TESTRAN and problem program source 
modules are assembled together and result in a Single object module. In 
the second case, the source modules are assembled separately, result in 
separate object modules, and are processed by the linkage editor to form 
a Single load module. 


TESTRAN Problem 


Source Program 
Module Source 
Module 


Problem 
TESTRAN Program 
Object Object 


Module ae Module 
| 


L. Module _! 





— -_— —_ 
—-——_ ee oe 


Combined 
Load 
Module 


Combination of modules by the assembler 
— —— ~— Combination of modules by the linkage editor 





Figure 2. Combination of TESTRAN and Problem Program Source Modules 


The single load module is loaded and executed as a problem program. 
Requests for test services are interpreted by the TESTRAN interpreter, a 
component of the control program that receives control during program 
interruptions. As shown in’ Figure 3, the TESTRAN interpreter places 
test information in a TESTRAN data set, along with control information 
which it copies from the unloaded form of the load module. 


Load 
Module 


‘ 7 
Control Information » 
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TESTRAN 


Interpreter 


Problem 


Program 








Test Information —~—~ TESTRAN 
Data Set 





Figure 3. Execution Time Testing of the Problem Program 


Test information, in the form of dumps and traces, is printed by the 
TESTRAN editor, as shown in Figure 4. A dump is a symbolic representa- 
tion of data as it existed at a particular time during execution of the 
problem program. A trace is a record of control flow or references to 
data over a period of time. 
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Figure 4. Printing of Test Information 


Like the assembler and the linkage editor, the TESTRAN editor is a 
processing program that is executed as a job step. It uses the control 
information copied from the load module to edit test information into a 
meaningful symbolic -format. The control information includes symbol 
tables and a control dictionary for each object module that is included 
in the load module. The control dictionary is produced as a standard 
feature of assembly, while the symbol table is produced aS an optional 
feature. Both are placed in the load module as an optional feature of 
linkage editing. 


REQUESTING TESTRAN SERVICES 


Requests for TESTRAN services are written as statements in the 
TESTRAN source module. Each statement is a coded TESTRAN macro- 
instruction, which the assembler automatically replaces with a series of 
constants. The constants, in effect, are a control statement that 
directs the TESTRAN interpreter to perform a specific operation. 


When the interpreter performs a requested operation, the operation 
itself determines whether the next sequential macro-instruction is 
interpreted, or whether a logical branch is made to some other 
macro-instruction. The process of interpreting a TESTRAN macro- 
instruction thus resembles the execution of a machine instruction, and 
is more conveniently referred to hereafter as the execution of a TESTRAN 
statement. 


STRUCTURE OF TESTRAN STATEMENTS 


The structure of TESTRAN statements is similar to that of statements 
in the basic assembler language. Each statement includes an operation 
code and one or more operands. The operation code cen be preceded by a 
symbolic name, and the operands can be followed by a comment. 


The operation code and first operand together define the type of 
operation to be performed, and are used as generic names for statements. 
For example, a DUMP MAP statement dumps a map of control sections and 
allocated storage areas; the operand MAP distinguishes this’) statement 
from DUMP statements that request other types of dump operations. 


FUNCTIONS OF TESTRAN STATEMENTS 


The operations requestea by TESTRAN statements provide the following 
general functions: 


e Recording functions, which provide dumps and traces of the prceblem 
program. 


e Linkage functions, which control linkage to the TESTRAN interpreter. 
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e Decision-makin functions, which provide condition testing and 
conditional branching. 


® Branchin functions, which provide unconditional branching and 
subroutine capabilities. 


e Assignment functions, which control values of variables in the 
problem program and of special variables used in decision making. 


These functions are provided by statements that are formally 
described in Appendix A. Functionai descriptions of the statements 
appear in the next section, which describes how to write statements for 
typical test applications. 
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SECTION 2: HOW TO WRITE TESTRAN STATEMENTS 


This section shows how to write TESTRAN statements to perform typical 
testing functions. It gives examples of statements for performing each 
function, and the reader can adapt these examples to his own needs. If 
there is some question about adapting a specific example, refer to 
Appendix A for complete, formal descriptions of the statements involved. 


Section 2 has three parts: 


e Basic Recording Functions 
e Testing of Complex Programs 
e Logical Functions 


The first part shows how to program various types of dumps and traces. 
The second part shows how to test programs that are not simply 
structured or not formed from single object modules. The third part 
Shows how to perform various logical functions, such as the detection 
and correction of error conditions. 


The first part of Section 2 should be of general interest, while the 
others should be read or ignored according to individual need. Each 
part discusses various topics, and these also should be studied in a 
selective fashion. 


Note: TESTRAN statements can either follow or precede source statements 
of the problem program. If they follow, however, they must’ follow 
statements of a regular control section. They must not directly follow 
statements of a dummy or blank common control section. 





BASIC RECORDING FUNCTIONS . 

This part of Section 2 describes various types of dumps and traces. 
Remember that a dump represents data as it exists at a particular time; 
a trace represents control flow or references to data over an extended 
period of time. 

HOW TO DUMP A STORAGE AREA 


Assume that the program containing the area is very Simple and can be 
represented as follows: 


ENTRY SAVE (14,12) 
PROCESS MVC MYDATA (20) ,0(6) 


MYDATA be C*DATAAREA' 
DC Er Op lee” 


END ENTRY 
THe problem might then be to dump the 20-byte area beginning at MYDATA, 


just before the contents are changed by PROCESS. If so, the next 
listing shows a solution: 
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NEWENTRY TEST OPEN, ENTRY 
TEST AT,PROCESS 
DUMP DATA,MYDATA, MYDATA+t20 


END NEWENTRY 





Execution begins at NEWENTRY, the beginning of a TESTRAN sequence that 
means “Enter the problem program at ENTRY; at PROCESS, dump the area 
from MYDATA to MYDATAt20." In this sequence, only the first statement 
is actually executed. This statement uses the information in another 
statement (TEST AT) to synchronize testing specified by a third 
statement (DUMP DATA) with execution of. the problem program. It 
establishes a test point (a special link to the TESTRAN interpreter) at 
PROCESS, and passes control to ENTRY. When PROCESS is reached, the 
interpreter executes the DUMP DATA statement; it returns control to the 
problem program, where the MVC instruction is executed. The dump is 
printed as: 


0090 MYDATA 
O05F68 DATAAREFA +0 +1 +2 


assuming that MYDATA was assembled at location 000090 and loaded at 
location OO5F68. 


To dump more than one area, the programmer simply writes additional 
DUMP DATA statements: 


DUMP DATA,MYDATA, MYDATA+2 
DUMP DATA,C0(0,6),80(0,6) 





To dump these areas at more than one point in the program, he specifies 
additional instruction addresses in the TEST AT statement: 


INPUT+18 





To dump different areas at various test points, he uses additional TEST 
AT statements: 
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allocated age area: oes not, the a y be dis by 
scatter loading of control sections or by variation in the relative 
locations of separately allocated areas. Also, if a dumped area begins 


in one control section and ends in another, only data from the first 
control section can be formatted properly. 


In a system with storage protection, the TESTRAN interpreter limits 
dumps to contiguous storage blocks that have the same protection key as 
the job step task: 


e In a system with MFT, a dump is truncated at the end of the job step 
partition. 


e In a system with MVT, a dump is truncated at the end of the job step 
region, or at the beginning of a block within the region that has 
the supervisor protection key. (The supervisor protection key is 
assigned to re-enterable programs from the link and SVC libraries, 
to certain blocks used by the control program, and to blocks not 
assigned to any subpool.) 


HOW TO DUMP CHANGES TO A STORAGE AREA 


The method is the same as for dumping a storage area; the basic 
Gifference is that CHANGES replaces DATA in the DUMP statement: 


DUMP CHANGES, MYDATA, MYDATA+20 





Execution begins at NEWENTRY and continues at ENTRY. Before PROCESS is 
executed, the TESTRAN interpreter dumps the 20-byte area at MYDATA. If 
PROCESS is executed three times, the dumps may appear as: 
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0090 MYDATA 
005F68 DATAAREA +0 +1 +2 
0090 MYDATA 
005F68 WORKAREA +3 


00A0 
O005F78 -41 


The first dump shows the full contents of the four fields assembled at 
000090 and loaded at 005F68. The second shows changes to the first, 
second, and fourth fields, and shows that the third field is unchanged. 
The third dump shows that only the fourth field has changed since the 
previous dump. 


To show changes to an area, a DUMP CHANGES statement must be executed 
more than once. If PROCESS were executed only once, the example would 
have to be changed to specify additional test points: 
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Change aumps would then occur at the test points PROCESS, INPUT, and 
INPUT+18. There might be other TESTRAN statements to be executed, 
however, and these statements might not be the same for each test point. 
In this case, it would be necessary to use branching statements: 


TO, CONTINUE 


TO, CONTINUE 





The statement CONTINUE is the last executed at each test point. The GO 
TO statements in no way affect the logic of the program being tested; 
control is returned to each test point in the normal manner. 


To dump changes to more than one area of storage, the programmer 
should specify each area in a separate statement: 


a 


f 
UMP CHANGES, TABLE (4) , TABLE+8 (4) 





Each statement produces a separate series of change dumps, even if two 
statements should specify the same storage area. Each dump shows 
changes to the area Since the last dump by the same statement. 


Changes in index values redefine areas that are specified by indexed 
addresses. For example, the statement 


DUMP CHANGES, ALPHA(4), ALPHA+60 (4) 


dumps a 60-byte area whose location depends on an index value in general 
register 4. On the first execution of the statement, the index value 
might be zero, causing a dump of the area from ALPHA to ALPHAt60. On 
the next execution, the index value might be 40, redefining the aumped 
area as that from ALPHA+40 to ALPHA+100. The second dump would show 
changed fields from ALPHA+40 to ALPHAt60 and all fields from ALPHA+60 to 
ALPHA+100. 


HOW TO DUMP A DUMMY CONTROL SECTION 
A dummy control section describes a storage area without actually 


reserving the area. The area may be allocated during execution, or may 
be reserved by a regular control section, as in the following example: 
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“4, MYDATA 
USING DUMMY, 4 
i 20 


DSECT 
DS XL4 
DS uF 





This program defines a dummy Control section named DUMMY, and assigns it 
the storage reserved for MYDATA. The example otherwise is the same as 
that used in “How to Dump a Storage Area." The instruction named 
PROCESS here refers to DUMMY rather than MYDATA, but its effect is the 
same as in the earlier example. 


Assume that DUMMY is to be dumped after PROCESS has been executed, 
and that the 20-byte area at MYDATA is to be dumped as_ before. The 
program then becomes: 


TEST AT,PROCESS+6 
USING DUMMY, 4 
DUMP DATA,COUNT,NUMBERS+16,DSECT=DUMMY 





As before, execution begins at NEWENTRY, control is passed to ENTRY, 
and the area of MYDATA is dumped at PROCESS. After PROCESS is executed, 
the new statements dump the 20 bytes from COUNT to NUMBERS+16. Thus, 
the two dumps of the same area might appear as follows: 
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Form C28-6648-0, Page Revised by TNL N28-2249, 6/27/67 


0090 MYDATA 
005F68 DATAAREA +0 +1 t2 


0000 COUNT NUMBERS 
005F68 00002A6 -647 #30. -=1 


The dumps show that MYDATA was assembled at 000090 and that COUNT was 
assembled at 000000; both had the same location (005F68) when dumped. 


Note that a special operand (DSECT=DUMMY) points to a dummy control 
section, which is made addressable by a USING statement. A USING 
statement iS not needed preceding the other TESTRAN statements, since 
their address operands are assembled as A-type address constants. 


A dummy control section may describe more than one area of storage; 
for example, it may define each of several kuffers ina buffer pool. If 
the areas are contiguous, they can be dumped by a single statement, as 
in the following example: 


MM 


/ DUMP DATA, COUNT, NUMBERS+16 , DSECT= (DUMMY, 3 





PROCESS moves data into a 60-byte area beginning at DUMMY, i.e., at 
MYDATA. This area is dumped as three 20-byte areas 
( (NUMBERS+16) -COUNT=20), each area having the format defined in DUMMY: 


0000 COUNT NUMBERS 

005F68 000002A6 -647 e300 a 
0000 COUNT NUMBERS 

OO5F7C 00000006 +4 +0 =2 
0000 COUNT NUMBERS 

005F90 000001CF +278 -64 -89 


Changes to a dummy control section can be dumped, just as changes to 
a regular control section. For this purpose, a DUMP CHANGES statement 
(with a DSECT operand) is used in place of a DUMP DATA statement. For 
examples of the use of DUMP CHANGES, refer to "How to Dump Changes to a 
Storage Area." 
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HOW TO DUMP STORAGE MAPS, REGISTERS, AND CONTROL BLOCKS 


For simplicity, assume that a storage map, registers, and control 
blocks should all be dumped at X in the following program: 


START SAVE (14,12) 


OPEN (MYDCB, (OUTPUT) ) 
x . 


MYDCB DCB DSORG=PS, MACRF= (PM) , DDNAME=MYDD 
END START 


The unshaded statements below perform these functions: 


MAP 

PANEL 

TABLE, TCB 
TABLE, DCB, MYDCB 
TABLE, DEB, MYDCB 





‘Execution begins at NEWSTART, where X is established as a test point. 
Control passes to START, and the DUMP statements are executed at X. The 
dumps appear as follows: 


Storage Map (recorded by DUMP MAP): 


NAME TYPE CSECT NAME ASSEMBLED AT LOADED AT LENGTH-DEC HEX 
GO LOADED PROGRAM NEWS TART 000000 009020 47 2F 
LOADED PROGRAM 000030 009050 172 AC 

TEGTTRNK LOADED PROGRAM 009120 1048 418 
IEGTTROT LOADED PROGRAM 07F3D0 1160 488 
OBTAINED STORAGE O7F858 96 60 

OBTAINED STORAGE O7F948 560 230 


OBTAINED STORAGE O7FBBO 360 168 


Registers (recorded by DUMP PANEL): 


G'00' QOO7FD58 G'01' O007FD58 G'02' 00000058 G'03' 50009050 G'04' ODQOGEES G'05' OOO7FFSC G'06' 00005480 Gt07' o0000000 
G*'08* 0000003C G'09' 40011062 G'10" OOO7FFIC G'11' OOO7FF5C G'12' 00000180 G'13' OO007FE98 G'14' 50009088 G'15' 92007750 
PSW FF 1 5 0026 4 0 00908A CC=0 FIX POINT OVERFLOW OFF DEC OVERFLOW OFF EXP UNDERFLOW OFF SIGNIFICANCE OFF 

F'O* 00000000 00000000 F'2* 00000000 0000000 F'&* 00000000 coDD0000 F'6' O0000000 00000000 
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Task Control Block (recorded by DUMP TABLE, TCB): 


SECTION FIELD NAME CONTENTS 


TCBFRS 00000000 00000000 00000000 82000170 00040000 0007DCB8 00000000 00000000 

TCBRBP 00009100 

TCBPIE ooo00000 

TCBDEB 0O007FCDC 

TCBTIO OOO7FFS5C 

TCBCMP 00000000 

TCBTRN 0007F948 

TCBMSS 00005670 

TCBPKF 10 

TCBFLGS 00000000 00000000 00000000 00000000 00000000 

TCBLMP 000 

TCBDSP 000 

TCBLLS O007F3A8 

TCBJLB 00000000 

TCBJUSE 00000000 

TCBGRS 000000C6 00005480 800092F4% O007FBO4 4O07FF844 SO0004C1A 00000001 0007FAFO 0007FA90 0007FE58 
QOO7FAFO 04000030 O010000AC 40404040 40404040 40404040 

TCBIDOF 01000000 

TCBFSA 404040 

TCBTCB 40404040 

TCBTME 40404040 


Data Control Block (recorded by DUMP TABLE,DCB,MYDCB) : 


SECTION FIELD NAME CONTENTS 
DEVICE DEPENDENT INTERFACES 
OCB 00000000 00000000 00000000 00000001 00810000 
COMMON INTERFACE 
DCB 0207FC10 00004000 00000001 
FOUNDATION BLOCK EXTENSION 
DCB 42000001 80000000 
FOUNDATION BLOCK 
OCB 00400050 OO007FCDC 92 
ACCESS METHOD INTERFACES 
DCB 00775000 007B880C 00000100 09005028 28282840 O7FBE000 O7FCB800 O7FCB800 00005000 00000100 
00000000 00884848 70201EC9 C5C7E3E3 D9ID5C600 4COO040F6 40404000 00000000 00000002 0026FE06 
78000140 40404040 40404000 00000000 00000002 0027FE06 78000140 40404040 40404000 00000000 
00000002 0028FE06 78000140 40404040 40404000 00000000 00000002 O029FE06 18000140 40404040 


40404000 00000000 00000002 OO2AFE06 78000340 40404040 40404000 00000000 00000002 0O02DFE06 
78000106 % 


Data Extent Block (recorded by DUMP TABLE, DEB, MYDCB): 


SECTION FIELD NAME CONTENTS 
PREFIX SECTION 


DEBWKARA 00 

DEBDSCBA 00000000 000000 

DEBDCBMK 00000000 00000001 10011111 11100000 
DEBLNGTH oc 


NUCLEUS 
DEBNMSUB 003 
DEBTCBAD 000180 
DEBAMLNG 004 
DEBDEBAD 07F87C 
DEBOFLGS 11001000 
DEBIRBAD 000000 
DEBOPATB 00001111 
DEBSYSPG 000000 
DEBNMEXT 001 
DEBUSRPG 000000 
DEBPRIOR 000 
DEBECBAD 000000 
DEBPROTG 001 
DEBDEBID 015 
DEBDCBAD 00909C 
DEBEXSCL 002 
DEBAPPAD O7FCB8 

EXTENT 


DEB 33002000 
ACCESS METHOD 

DEB 00010000 
SUBROUTINE ID 


DEB c1p9C1ip2 1000 
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The format of each dump is explained in "Section 4: How to Interpret 
System Output." Note that: 


e The storage map shows the length and location of each program that 
was loaded and each storage area that was obtained for the active 
task. The first program (GO) is the problem program; the others are 
components of the TESTRAN interpreter. GO includes two control 
sections: NEWSTART, which is defined by the TEST OPEN statement and 
contains all five TESTRAN statements, and an unnamed control 
section, which contains the problem program instructions. 


e The dump of registers includes both the general and floating-point 
registers, assuming that the computing system includes the floating- 
point option. It also includes the program status word (PSW) that 
was stored when the problem program was interrupted at the current 
test point. 


e The dumps of control blocks show the task control block (TCB) for 
the active task, the data control block (DCB) named MYDCB, and the 
data extent block (DEB) created during the opening of MYDCB. 


In the second dump, the contents of all registers appear in 
hexadecimal format. The programmer can specify a different format (such 
as fixed-point or floating-point) in the DUMP PANEL statement (refer to 
"How to Control Output Format)." Since the specified format applies to 
all registers dumped by the statement, it is often desirable to use 
separate statements for dumping general and floating-point registers: 


DUMP PANEL,G'0,15' 
DUMP PANEL,F'0,6' 


The first statement dumps the general registers 0 to 15; the second 
dumps the floating-point registers 0 to 6. The programmer can also 
select specific registers, as in the statement 


DUMP PANEL, (G'4',G'SUM',G'8,9',G'13,1") 
which dumps only the following general registers: 
Register 4. 
The register whose number is the value of the symbol SUM. 


Registers 8 and 9. 
Registers 13, 14, 15, 0, and 1. 


Of course, if the programmer wishes to dump specific general and 
floating-point registers, and to dump both in the same format, he can 
specify them in a single statement, such as: 


DUMP PANEL, (G'5',F'SUM',F'4,6',G'8,10') 


HOW TO CONTROL OUTPUT FORMAT 


The TESTRAN editor determines the format of the output from most 
TESTRAN statements. However, the statements 


DUMP DATA 
DUMP CHANGES 
DUMP PANEL 
TRACE REFER 


produce output whose format may be determined in any of three ways: 
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1. By special operands. 
2. By symbol tables. 
3. By default. . 


By understanding each way of determining format, and the conditions 
under which it is used, the programmer can control the format of data 
recorded from registers and main storage. 


SPECIAL OPERANDS: There are two operands by which the programmer can 
specify output format: 


e The DATAM operand, which defines storage field or register format. 
e The NAME operand, which defines a field name. 


The DATAM operand can be used in any of the four statements; the NAME 
operand can be used in a DUMP DATA or DUMP CHANGES statement. 


The DATAM Operand: The DATAM operand specifies the format of a field or 
register in terms of three attributes: 


e Type 
e Length 
e Scale 


The specification of attributes is similar to that in an assembler DC or 
DS statement and is illustrated by the following statements: 


Di DUMP DATA, INPUT+6,DATAM=L74 

D2 DUMP CHANGES,0(0,13),72(0,13) , DATAM=L4 
b3 DUMP PANEL, F'0,6',DATAM=D 

T1 _ TRACE REFER, TABLE, TABLE+80 , DATAM=FLUS- 2 


Di dumps a single field that begins at INPUT+6. The length of the 
field is 74 bytes; because no type is specified, the contents of the 
field are printed as hexadecimal data. 


D2 dumps a series of up to eighteen 4-byte fields, each containing 
changes to the contents of a 72-byte storage area. 


D3 dumps the old program status word (OPSW) and the contents of the 
floating-point registers. The type of data in the registers is 
specified as D (long floating-point), which implies a length of 8 bytes 
for each. 


Tl traces references to 4-byte fields within an 80-byte area. The 
trace shows the contents of a 4-byte fixed-point field beginning at each 
address to which a reference is made. The contents before and after the 
reference are shown multiplied by the scale factor (27-2). 


The NAME Operand: The NAME operand specifies a symbol that is printed 
as the name of a field dumped by a DUMP DATA or DUMP CHANGES statement. 
Its use is illustrated by the following statements: 


D1 DUMP DATA,TABLE(6) , DATAM=CL8, NAME=FUNCTION 
D2 DUMP CHANGES, MATRIX, MATRIX+160, NAME=NEWMATRX 


D1 dumps a single 8-byte field located at TABLE(6). FUNCTION is 
printed as the name of the field. 


D2 dumps a 160-byte area, which may contain any number of fields. 
NEWMATRX is printed as the name of the first field that is dumped. 
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SYMBOL TABLES: Symbol tables are part of the control information that 
is passed to the TESTRAN editor by the TESTRAN interpreter. (See Figure 
3.) Produced by the assembler, each symbol table describes fields 
defined in a named, unnamed, dummy, or blank common control section. 
The TESTRAN editor uses the symbol tables to: 


e Determine field formats when the DATAM operand is omitted. 
e Provide field names when both the DATAM and tne NAME operands are 
omitted. 


A blank common control section is common to two or more object 
modules, and is therefore represented by more than one symbol table. To 
print fields defined in a conmon control section, the TESTRAN editor 
identifies the object module in which the test point was located, and 
uses the symbol tabie for the control section as defined in that module. 


Except in the case of a blank common control section, the symbol 
tables define only one format for a given area of storage. They do not 
define the format of fields that are overlapped by other fields, as in 
the following sequence: 


LONGFLT DS D 
SHORTFLT DS E 

ORG *-8 
ADRLONG DC A(LONGFLT) 
ADRSHORT DC A(SHORTFLT) 


This sequence defines fields that together occupy three full words. 
LONGFLT occupies the first two words, the second of which is overlapped 
by ADRLONG. SHORTFLT occupies the third word and is overlapped by 
ADRSHORT. If the three words were dumped, the first would be printed in 
default format, and the second and third would be printed as normal 

address constants. 


DEFAULT: The fields described in the symbol tables are storage areas 
and constants defined by assembler DS and DC. statements. Instructions 
are described only if named, and are therefore assumed to be the 
contents of any program area whose format is not defined in the tables. 


The area contents are analyzed for operation codes, which are used to 
determine the printing format for each instruction. 


Unless treated as a dummy control section, an allocated area of main 
storage is not representeac by a symbol table. By default, data from 
such an area is printed in 4-byte hexadecimal fields. Data from 
registers, including floating-point registers, is also printed in this 
format. 
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HOW TO TRACE CONTROL FLOW AND REFERENCES TO DATA 


Suppose that the following sequence is the program to be traced: 


BEGIN SAVE (14,12) 
REPEAT ST 6, MYDATA 
DECIDE BC 4, REPEAT 


CONTINUE CALL ROUTINE1 
NEXTSTEP SR 5,5 
MYDATA pc F*0* 


END BEGIN 


The problem is to trace control flow from BEGIN to NEXTSTEP and to trace 
references to the area beginning at MYDATA. The traces are to ope 
Started at BEGIN and are to be stopped at NEXTSTEP. 


The next sequence shows a solution: 


’ F 
RACE CALL,CONTINUE, NEXTSTEP : 
RACE REFER, MYDATA, MYDATA+72 | 
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Execution begins at NEWBEGIN, where a TEST OPEN statement establishes 
BEGIN and NEXTSTEP -as test points. NEWBEGIN passes control to. BEGIN, 
where three traces are started: 


e The TRACE FLOW statement starts a trace of branches and supervisor 
calls to, from, or within the area from BEGIN to NEXTSTEP. 


e The TRACE CALL statement starts a trace of subroutine calls by CALL 
macro-instructions located between CONTINUE and NEXTSTEP. 


e The TRACE REFER statement traces references by instructions that 
could change data in the 72-byte area beginning at MYDATA. 


To perform these traces, the TESTRAN interpreter retains control and 
executes the program interpretively, starting at BEGIN. At NEATSTEP, 
‘the traces are stopped and execution continues normally. 


The printed output of the three traces can be represented, in 
abbreviated fashion, as follows: 


Recorded 
Output During Execution of: 


AT LOCATION BEGIN... 


e-eTRACE FLOW... 
STARTED 
TESTRAN Statements 
e--TRACE CALL... 

STARTED 


-+«-TRACE REFER... 
STARTED 


--.-TRACE REFER...TO MYDATA...FROM REPEAT... 
BEFORE +0 AFTER +16 


e--TRACE FLOW...FROM DECIDE...TO REPEAT...CC=1 


- Problem Program 


«--TRACE CALL...TO ROUTINE1...AT CONTINUE... 


AT LOCATION NEXTSTEP... 
TESTRAN Statements 
---TRACE STOP,AULL 


The output shows that the traces were started at BEGIN and stopped at 
NEXTSTEP. It shows that the following events occurred during execution 
of the problem program: 


e A reference was made to MYDATA by REPEAT, resulting in a new value 
of +16. 


e A branch was made from DECIDE to REPEAT on condition code l. 


e A call was made to ROUTINE1 from CONTINUE. 
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Complete output, as actually printed by the TESTRAN editor, would also 
show the images of certain instructions, the values of symbolic 
addresses, and the contents of pertinent registers. 


Suppose now that only the traces of control flow should be stopped at 
NEXTSTEP, and that the trace of references should ke continued until the 
end of the program. The TESTRAN statements should then be written as 
follows: 


RACE#1 TRACE FLOW, BEGIN,NEXTSTEP 
RACE#2 TRACE CALL, CONTINUE, NEXTSTEP 


TRACE STOP, (TRACE#1, TRACE#2) 





The TRACE STOP statement here stops only the traces started by the 
statements TRACE#1 and TRACE#2. The TESTRAN interpreter continues its 
interpretive execution of the problem program, and records references to 
the area at MYDATA until termination of the task. 


The TRACE STOP statement speeds up execution by reducing the number 
of traces. While any trace is in effect, the TESTRAN interpreter must 
examine each instruction before it is executed to determine whether it 
will cause some event, such as a branch, that must be recorded. This 
interpretive execution is necessarily slow, and the time it requires is 
reduced by stopping each trace when it is no longer needed. 


Testing efficiency is also increased by limiting the size of storage 
areas specified in TRACE statements. For example, if there were three 
adjoining areas, ali could be specified as a single area in ae single 
statement; however, if only the first and third areas were of real 
interest, it would be better to eliminate output from the second area by 
using two TRACE statements to specify the first and third areas 
separately. 


With respect to limiting traces, the following specific iimits should 
be kept in mind: 


e A trace area should lie entirely within a single control section or 
allocated storage area. If it does not, the area may be distorted 
by scatter loading of control sections or by variation in the 
relative locations of separately allocated areas. Also, if a trace 
area begins in one control section and ends in another, only data 
from the first control section can be formatted properly. 


e No more than ten traces (corresponding to ten TRACE statements) can 
be performed simultaneously. If an eleventh trace is started, the 
tenth trace -- the one most recently started -- is stopped 
automatically. 


A stopped trace can be restarted by executing again (at a later test 
point) the TRACE CALL, TRACE FLOW, or TRACF REFER statement that 
Originally started the trace. In the same way, an active trace can be 
shifted to a new area if the area is specified by indexed addresses 
whose values have changed since the trace was started. 


Traces of Asynchronous Exit Routines: Traces are stopped automatically 
when any of the following routines is entered: 


Section 2: How to Write TESTRAN Statements 27 


® The end of task exit routine Specified by the ETXR operand of an 
ATTACH macro-instruction. 


e The timer completion exit routine specified by a STIMER macro- 
instruction. 


e The error analysis exit routine specified by the SYNAD operand of a 
DCB macro-instruction. 


To trace execution of one of these routines, it is necessary to start 
traces at a test point within the routine. When the routine returns 
control to the control program, these traces are automatically stopped 
and the traces stopped on entry to the routine are automatically 
restarted. 


Traces are not stopped on entry to the program interruption exit 
routine specified by a SPIE macro-instruction. 


Use of Dummy Control Sections: The programmer can trace references to 
fields of dummy control sections by using the general technique 
described in “How to Dump a Dummy Control Section." If he assigns 
varying locations to the dummy control section, he can shift the trace 
from one location to the next as in the foliowing example: 


NEWSTART TEST OPEN,START 
TEST AT, LOADBASE+2 
USING RECORD, 6 
TRACE REFER, ID, DATE+5, DSECT=RECORD 


START SAVE (14,12) 


GETNEXT GET MYDCB 
LOADBASE LR 6,1 
USING RECORD, 6 


PUTX MYDCB 


B GETNEXT 
MYDCB DCB DSORG=PS, MACRF=(GL, PL) , DDNAME=MYDD 
RECORD DSECT 
ID DS XL4 
DATE DS PL5 


END NEWSTART 


GETNEXT uses register 1 to point to a buffer that contains a record to 
be updated. The program assigns the buffer location to RECORD, a dumniy 
control section that describes the record format. After processing the 
record, the program replaces it in the data set and executes the same 
set of instructions to update the next record. On each loop, the TRACE 
REFER statement is executed immediately after LOADBASE makes RECORD 
addressabie. When first executed, it starts a trace of references to 
the buffer containing the first record; on each subsequent execution, it 
shifts the trace to the buffer containing the next record. 
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HOW TO COMMENT THE TESTRAN LISTING 


A TESTRAN listing can become difficult to interpret when it contains 
many individual dumps and traces. To make the listing easier to 
interpret, the programmer can introduce comments that explain or call 
attention to particular items. 


The programmer specifies a comment as an operand of a special DUMP 
Statement (DUMP COMMENT) or in a special operand of a TRACE CALL, TRACE 
FLOW, or TRACE REFER statement. The following example illustrates both 
methods: 


TEST AT, PAYROLL 

TRACE CALL, CALLFICA, NEXTSTEP, COMMENT="TRACE OF CALLS TO PAYROL- 
L SUBROUTINES' 

TEST AT,TESTCODE-4 

DUMP COMMENT,'G''15** CONTAINS FICA RETURN CODE‘ 

DUMP PANEL,G'‘'15' 


The comment TRACE OF CALLS TO PAYROLL SUBROUTINES is printed with all 
output produced by the TRACE CALL statement. The comment G'15' CONTAINS 
FICA RETURN CODE is printed immediately before the dump of register 15. 


(Note that the apostrophes in the second comment are each represented by 
a pair of apostrophes in the statement. This representation is 
necessary because apostrophes are used to delimit the comment; for other 
reasons, ampersands must be represented in the same way.) 


HOW TO CLASSIFY TEST INFORMATION FOR SELECTIVE RETRIEVAL 


To avoid printing large quantities of test output, the programmer can 
divide the output into several classes that can be retrieved 
selectively. By means of a job control statement, he can select one or 
more classes for printing immediately after execution of his program. 
From this information he can decide what other classes he needs for his 
evaluation of the program. He can then select these classes by 
submitting a new job that reprocesses the TESTRAN data set. 


To classify output, the programmer writes a special operand (SELECT) 
in one of the following statements: 


e TEST OPEN 
e TEST AT 
e Any DUMP or TRACE statement 


Depending on where it appears, the SELECT operand classifies: 


e Information recorded at the test points established by a TEST OPEN 
statement. 

*¢ Information recorded at the test point(s) specified in a TEST AT 
statement. 

e Information recorded by an individual DUMP or TRACE statement. 


The SELECT operand classifies information by means of a class 
identification number (an integer from 1 to 8), as in the following 
statement: 


Za TEST OPEN, ENTRY, SELECT=8 
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All information recorded at the test points established by this 
statement belongs to class 8, except for information that is reclassi- 
fied by a TEST AT, DUMP, or TRACE statement. Thus, if T1 is followed by 


TEST AT,PROCESS,SELECT=6 


all information recorded at PROCESS belongs to class 6, except for 
information that is reclassified by a DUMP or TRACE statement, such as: 


DUMP DATA,MYDATA,SELECT=5 


The dump of MYDATA belongs to class 5, and only to class 5. As a result 
of reclassification, it does not belong to either class 6 or class 8. 


Use of the SELECT operand does not imply that all information must _ be 
classified. Unclassified as well as classified information can be 
selected for printing. 


TESTING OF COMPLEX PROGRAMS 


This part of Section 2 describes the testing of programs that are not 
Simply structured or are not formed from single object modules. 


HOW TO TEST A MODULE ALREADY IN A LIBRARY 


As stated in Section 1, TESTRAN statements and the proolem program 
can be assembled together or separately. Assembling the two together is 
usually the more convenient, but the sophisticated programmer may 
discover cases where separate assembly is more efficient. For example, 
the programmer may have assembled and tried to execute a program before. 
deciding to use TESTRAN. If he has saved the program ina library, he 
may wish to assemble TESTRAN statements separately to avoid reassembling 
the program to be tested. 


Separate assembly presents two major problems. First, there is no 
Simple symbolic way that TESTRAN statements can refer to locations in 
the problem program. Second, assuming that the object or load module in 
the library contains no symbol tables, there is no Simple way of 
obtaining TESTRAN output in the proper symbolic format. 


References to the Problem Program: There are three ways that TESTRAN 
statements can refer to locations in the problem program. The first, 
which is the only way that can be used in TEST OPEN and TEST AT 
Statements, is to write each address as an external reference plus or 
minuS an appropriate displacement. The external reference is a symbol 
defined in the problem program and listed in the external symbol 
dictionary (the first part of the assembly listing). The displacement 
is the number of bytes from the location named by the symbol to the 
location of the operand; it can be calculated from the object code 
addresses contained in the assembly listing. 


The second way of referring to the problem program is by explicit 
addresses. These can be written to use base registers loaded by the 
problem program. Displacements ‘from base addresses can be calculated 
from the object code addresses in the assembly listing. 

The third way of referring to the problem program is to use dummy 
control sections that describe the format of the problem program. The 
name of each must be declared as the address in a base register that is 
loaded by the problem program. Areas defined in the aummy control 
sections (which correspond to areas in the problem program) can then be 
referred to symbolically by DUMP DATA, DUMP CHANGES, and TRACE REFER 
statements that are written with DSECT operands. Remember that TESTRAN 
statements must not follow statements of a dummy control section. 
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Output Format: The output of DUMP DATA, DUMP CHANGES, and TRACE REFER 
Statements iS printed as four-byte hexadecimal fields unless each 
statement contains a DATAM or DSECT operand. The DATAM operand 
specifies a uniform field format for all data in the area specified by 
the statement. The DSECT operand specifies use of the symbol table for 
a dummy control section that is assembled with the TESTRAN statements. 


Symbol tables are optional features of assembly and linkage editing, 
and are requested by means cf job control statements. If the programmer 
anticipated the use of TESTRAN, he could have requested symbol tables 
when the problem program module was created. The tables for the problem 
program could then be used to determine the output format. 


Linkage Editing and Execution: After being assembled, the TESTRAN 
module (TESTRAN statements and dummy control sections) is processed by 
the linkage editor. The programmer must provide linkage editor control 
statements to combine this module with the proklem program module. For 
example, the statements: 


INCLUDE MYLIB(MYPROG) 
ENTRY NEWSTART 
NAME MY PROG (R) 


specify that the load module is to include the load module MYPROG from 
the library MYLIB; that the entry point is to be NEWSTART (assumed to be 
the name of a TEST OPEN statement); and that the new load module is to 
replace the original problem program module in the library. 


The normal procedure is followed in executing the new load module and 
printing the TESTRAN output. If the output shows an error ina 
particular control section, tne programmer can replace the control 
section with a new one through use of the linkage editor. Since a 
symbol table can be requestea when assembling the new control section, 
the programmer may wish to eliminate DATAM or DSECT operands in TESTRAN 
statements that refer to the control section. If so, he assembles a 
complete new set of TESTRAN statements, which form an implicit control 
section named after the TEST OPEN statement. If each new control 
section is named after the control section it replaces, the replacement 
is automatic, and only two linkage editor control statements are needed: 


INCLUDE MYLIB(MYPROG) 
NAME MYPROG (R) 


When the new load module is tested, the TESTRAN output may show an 
error in one of the replacement control sections. If there is a symbol 
table for this control section, the control section should not be 
replaced with another of the same name. The linkage editor does not 
replace symbol tables when it replaces control sections; therefore, the 
table originally associated with each section name remains in effect. 


Test Completion: When testing is completed, the programmer can direct 
the linkage editor to prepare the load module for productive use. For 
example, he might write the following control statements: 


ENTRY START 
REPLACE NEWSTART 
INCLUDE MYLIB(MYPROG) 
NAME MYPROG (R) 


These statements restore the normal entry point (START) and delete the 


TESTRAN control section (NEWSTART). Symbol tables in the module are 
deleted as a result of omitting an option in a job control statement. 
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HOW TO ENLARGE ON A PARTIALLY TESTED PROGRAM 
Suppose that the following program has been tested successfully: 


TESTMOD1 TEST OPEN,MOD1 


MOD1 CSECT 


END TESTMOD1 


MOD1 is now tc become a subroutine of another control section, MOD2, and 
the two control sections are to be tested together. The enlarged 
program is as follows: 


ESTMOD2 TEST OPEN, MOD2,OPTEST=TESTMOD1 


CSECT 


ALLMOD1 CALL MOD1 


END TESTMOD2 





Execution begins at TESTMOD2, the first of a group of TESTRAN statements 
for testing MOD2. In effect, this statement executes the statement 
TESTMOD1; as a result, it establishes test points as specified by TEST 
AT statements following both TESTMOD1 and TESTMOD2. TESTMOD2 ignores 
the second operand (MOD1) of TESTMOD1i and passes control to the problem 
program at MOD2. 


Because MOD1 has been tested previously, test information about MOD1 
is simply insurance against unexpected errors. The programmer may 
therefore wish to defer printing this information until after he has 
examined the information about MOD2. If so, he can classify the 
information about MOD2 and select only this information for immediate 
printing. He can save the data set that contains the information and, 
if it proves necessary, select the information about MOD1 at a later 
date. 


The programmer classifies information about MOD2 by means of a 
special operand (SELECT) described in "How to Classify Test Information 
for Selective Retrieval." There are several statements in which he can 
write this operand, but for the present purpose he can best write it in 
the TEST AT statements that follow TESTMOD2: 
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TEST AT, MOD2, SELEC 


TEST AT,CALLMOD1, SELECT=8 





The programmer can select information about MOD2 by specifying class 8 
in a job control statement, as explained in Section 3. Ina later job, 
he can repeat the editing of TESTRAN output and select unclassified 
output to print information about MOD1. 


The SELECT operands in the TEST AT statements classify information 
recorded at test points in MOD2. A SELECT operand in the statement 
TESTMOD2 would provide the same function if that statement did not 
include the operand OPTEST=TESTMOD1. In a TEST OPEN statement, a SELECT 
operand classifies information recorded at all test points established 
by the statement, including those established as the result of an OPTEST 
operand. A SELECT operand in TESTMOD2 would therefore classify informa- 
tion recorded at test points in both MOD2 and MOD1. It would do so even 
if a different SELECT operand (e.g., SELECT=7) were written in TESTMOD1, 
because the operands of a TEST OPEN statement are ignored if the 
statement is not actually executed. 


HOW TO TEST AN OVERLAY PROGRAM 


An overlay program is a load module that is divided into several 
overlay segments. For testing purposes, each segment must be treated as 
a separate program. That is, it must contain its own TESTRAN state- 
ments, beginning with a TEST OPEN statement. During execution, only one 
TEST OPEN statement can receive control; it must be located in the root 
segment, and it must contain a special operand (OPTEST) that points to 
all other TEST OPEN statements, as in the following example: 


TESTSEG1 TEST OPEN, ENTRY, OPTEST=(TESTSEG2, TESTSEG3) 
Segment 1 . 
(Root Segment) Z 


TESTSEG2 TEST OPEN 


Segment 2 r 


TESTSEG3 TEST OPEN 


Segment 3 * 


END TESTSEG1 


Except for references by the OPTEST operand, symbolic references between 
segments are not aliowed in TESTRAN statements. External references 
must be deciared in assembler EXTRN and ENTRY statements. 


A TEST OPEN statement and the TESTRAN statements that follow it form 
an implicit TESTRAN control section that must be inserted in the proper 
overlay segment. Thus, for the example just given, the programmer might 
write the following linkage editor control statements: 
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INSERT TESTSEG1,... 
OVERLAY ROOTNODE 
INSERT TESTSEG2,... 
OVERLAY ROOTNODE 
INSERT TESTSEG3,... 


When a segment is overlaid, traces started by TRACE statements in the 
segment are automatically stopped. They are not automatically restarted 
when the Segment is reloaded, but are restarted when the TRACE 
statements are again executed at a test point in the segment. To ensure 
that traces are restarted, the programmer must therefore design his 
testing logic so that TRACE statements are executed each time a segment 
is entered after being cverlaid and reloaded. 


HOW TO TEST A DYNAMIC SERIAL PROGRAM 


A dynamic serial program is a combination of two or more load nodules 
that are loaded and executed as a single task. Each load module can 
contain TESTRAN statements; if it does, however, it is neither reenter- 
able nor serially reusable. 


A module that is not reusable is normally loaded each time it is 
entered by a supervisor assisted linkage. For this reason, a TEST OPEN 
statement must be executed to establish test points each time the module 
is entered by means of a LINK, XCTL, or ATTACH macro-instruction. 
Before control .is passed or returned to another module, testing of the 
module should be stopped by a TEST CLOSE statement, as in the following 
example: 


EST AT,FINIS 
EST CLOSE 





At the test point FINISH, the TEST CLOSE statement nullifies the effect 
of the TEST OPEN statement and returns control to the test point. As a 
result, the TESTRAN interpreter releases storage areas acquired for 
internal functions. If not released, the areas would be duplicated the 
next time the module was loaded and tested. If the RETURN macro- 
instruction was replaced by an XCTL macro-instruction, the task would be 
abnormally terminated if TEST CLOSE were omitted. 


If a nonreusable module is loaded by a LOAD macro-instruction, the 
loaded copy of the module may be entered more than once before it is 
deleted. When an entry point is identified by an IDENTIFY macro- 
instruction, a used copy is considered reenterable. In systems with the 
primary control program or MFT, a used copy is considered serially 
reusable whenever it is not currently in use. The programmer must 
ensure that LOAD and IDENTIFY macro-instructions do not cause improper 
use of a module that includes TESTRAN. 


When a Supervisor assisted linkage is made to another module, all 
traces are automatically stopped. They are not automatically restarted 
when control is returned, but can be restarted by appropriate TRACE 
statements. The TRACE statements should follow a TEST AT statement that 
specifies the return address as a test point. 
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HOW TO TEST A DYNAMIC PARALLEL PROGRAM 


A dynamic parallel program is a combination of two or more load 
modules that are loaded and executed as more than a single task. A task 
may be the execution of a load module containing TESTRAN statements or 
the execution of several such modules as a dynamic serial program. 
Because TESTRAN modules are not reusable, the use of LOAD, ATTACH, and 
IDENTIFY macro-instructions should be restricted so that a single copy 
of a module is not executed under more than one task. 


For each task there must be a separate TESTRAN data set. The TESTRAN 
interpreter defines and opens the necessary data control blocks, but the 
programmer must provide the corresponding DD control statements. The 
programmer must point to one of these statements by means of a special 
operand (DDN) in the first TEST OPEN statement executed under each task. 
For example, the statement 


NEWENTRY TEST OPEN,ENTRY,DDN=TESTDD#1 


points to a DD statement whose ddname is TESTDD#1. Of course, a given 
TEST OPEN statement must not be executed first under more than one task, 
Since a unique DD statement is required for each data set. The 
processing of each data set by the TESTRAN editor must be performed as a 
Separate job step. 


When an ATTACH macro-instruction is executed, all traces are automat- 
ically stopped. These traces are not automatically restarted when 
control is returned to the next sequential instruction, but can be 
restarted by appropriate TRACE statements. The TRACE statements should 
follow a TEST AT statement that specifies a test point immediately 
following the ATTACH macro-instructicn. 


Traces are also stopped when a task is interrupted and another task 
is given control. When the interrupted task regains control, the 
stopped traces are restarted automatically. 


LOGICAL FUNCTIONS 


This part of Section 2 describes various logical functions: condi- 
tional testing, error recovery, and TESTRAN subroutines. 
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HOW TO TEST ON CONDITION 


The programmer can write a sequence of TESTRAN statements so that it 
will not be executed every time a particular test point is reached, but 
only when certain conditions are met. The programmer can choose any 
conditions he wishes, formulating each as a matter of count, logic, or 
arithmetic value. Thus, he can make dumps and traces dependent on such 
conditions as: 


e Reaching a particular test point more than a given number of times 
(a count condition). 


e Failing to enter a particular problem program routine (a logical 
condition). 


e Computing a value greater than some given value (an arithmetic 
condition). 


Testing on Count Conditions: Consider the following simple sequence of 
.TESTRAN statements: 


TEST AT, XX 
DUMP PANEL 


These statements perform a series of dumps at a test point XX ina 
problem program. They do so unconditionally, because the DUMP state- 
iments are executed every time that control passes to XX. 


Suppose now that XX .is located in a subroutine that may be called 
Many times. Since the test point may be reached repeatedly, uncondi- 
tional testing could produce very large amounts of TESTRAN output. To 
limit the output to a meaningful sample, the testing can be made 
conditional, as in the following sequence, which arbitrarily limits 
dumps to the first 24 times that XX is reached. 


TEST AT, XX 
TEST ON, ,24,,SAMPLE 
GO BACK 

SAMPLE DUMP PANEL 


The TEST ON statement is the first statement executed at XX. Each time 
control passes to XX, the statement adds one to a counter, which 
initially has a value of zero. The statement then tests the counter for 
a value of 24 or less. If the counter has such a value, the statement 
branches to SAMPLE, and the DUMP statements are executed. If the 
counter has a greater value, the next sequential statement is executed; 
this statement, GO BACK, returns control to the problem program. 


In this example, the TEST ON statement tests for a single condition: 
a counter value that is 24 or less. It can be written to test for 
further conditions, such aS a counter value that is 5 or greater and is 
a multiple of 2: 
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TEST ON,5,24,2,SAMPLE 


Each condition must be met, or no branch is made. Thus, no branch is 
made when the counter value is 5, because 5 is not a multiple of 2. The 
Statement aS written branches only on even values of the counter from 6 
to 24. 


When an operand is omitted, it has an assumed value that essentially 
negates testing for the condition it represents. For example, the 
second and fourth operands have assumed values of one; thus, the 
statement 


TEST ON, ,24,,SAMPLE 


tests a counter for a value that is not less than 1, is not greater than 
24, and is a multiple of 1. Since the counter value is 1 when the first 
test is made, the statement effectively tests only for a value not 
greater than 24. If the third operand were omitted, its assumed value 
would be 231-1, which is the highest value that the counter can attain 
and the highest value that can be specified for any of the three 
operands. 


At times, the programmer may want to test a counter against values 
that are generated auring execution. In a TEST ON statement, he can 
refer to any full-word fixed-point value in a register or in main 
storage, as shown by the following statement: 


TEST ON,G'6',MAXIMUM,G'REGX' ,CONTINUE 


This statement branches to CONTINUE on each counter value that is not 
less than the value in general register 6 (G‘'6'), is not greater than 
the value at MAXIMUM, and is a multiple of the value in the general 
register whose number is the vaiue of the symbol REGX. The contents of 
G'6', MAXIMUM, and G'REGX' are evaluated each time the statement is 
executed. 


It is sometimes useful to be akle to change the value of a counter 
and to use several TEST ON statements to test a single counter. In such 
instances, the counter must be given a name, as in the following 
example: 


NEWENTRY TEST OPEN, ENTRY 
TEST DEFINE, COUNTER, #PARAMS 
TEST AT,A 


TEST ON,1,G'3',G'3',FINISH, COUNTER=#PARAMS 
TEST AT,B 
TEST ON,1,G'3',G'3', FINISH, COUNTER=#PARAMS 


GO BACK 
FINISH SET COUNTER, #PARAMS,=F'O' 
DUMP COMMENT, 'LAST PARAMETER HAS BEEN PROCESSED. NUMBER OF PA- 
RAMETERS IS IN G''3°'.° 
DUMP PANEL,G'3' 
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When executed, NEWENTRY establishes test points A and B, and creates a 
TESTRAN counter named #PARAMS. The counter is defined by the TEST 
DEFINE statement, which, like the TEST AT statements, is used as a 
source of information but is not executed. The TEST OPEN statement 
passes control to ENTRY, the entry point of the program being tested. 


The statements in this example test a subroutine that is called to 
process a number of parameters. The number of parameters is provided in 
general register 3 (G‘'3'), and when each is processed, control passes to 
one of the two test points A and B. At either test point, a TEST ON 
statement increments the counter #PARAMS by one, so itS current value is 
always the number of parameters that have keen processed. When the 
value of the counter equals the value in G'‘'3', one of the TEST ON 
Statements resets the counter to its initial value of zero, and 
appropriate dumps are taken. The resetting of the counter prepares the 
TEST ON statements for use in testing the subroutine the next time it is 
called. 


Testing on Logical Conditions: Suppose that there is a problem program 
that calls a certain subroutine only when certain conditions in the 
program are satisfied. If the subroutine is called, testing is to occur 
at a test point SS in the subroutine; if the subroutine is not called, 
testing is to occur later at a test point XX in the calling routine. 


The following TESTRAN sequence makes testing at XX conditional on not 
testing at SS: 


NEWENTRY TEST OPEN, ENTRY 
TEST DEFINE, FLAG,SSTEST 
TEST AT,SS 
SET FLAG,SSTEST,=1 


TEST AT, XX 
TEST WHEN, SSTEST,RESET 


GO BACK 
RESET SET FLAG, SSTEST,=0 


When executed, NEWENTRY establishes test points at SS and XxX, and 
creates a TESTRAN flag named SSTEST. The flag is defined by a TEST 
DEFINE statement, in the same way as a TESTRAN counter. The TEST OPEN 
statement passes control to ENTRY, the entry point of the program being 
tested. 


The flag SSTEST is a single binary digit whose initial value is zero. 
If control passes to 3S, the flag's value is changed to one by a SET 
FLAG statement. When control passes to XX, the flag is tested by a TEST 
WHEN statement; if its value is one, a branch is made to RESET, a 
statement that resets the flag to zero before control is returned to the 
problem program. If the value of the flag is zero, the testing 
Statements following the TEST WHEN statement are executed. 


Suppose now that there is a second subroutine, which may be called if 
the first subroutine is not called. If it is called, testing is to 
occur at a test point TT in the subroutine; if it is not called, testing 
is to occur at SS or XX as before. The following sequence makes testing 
at XX conditional on not testing at either SS or TT. 
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EST WHEN, SSTEST,AND, TTTEST, ERROR 
EST WHEN, SSTEST,OR, TTTEST, RESET 


DUMP COMMENT,'SS AND TT WERE BOTH REACHED BEFORE XX 
SET FLAG,SSTEST,=0 





In this example, NEWENTRY establishes three test points (SS, TT, and XxX) 
and creates two TESTRAN flags (SSTEST and TTTEST). The flags are set to 
indicate testing at SS and TT; they are tested at KX by two TEST WHEN 
statements. The first TEST WHEN statement tests for an error condition: 
execution of both subroutines, indicated by both flags having values of 
one. If the error condition exists, the statement branches to ERROR, 
and an appropriate comment is inserted in the TESTRAN listing. If the 
error condition does not exist, the second TEST WHEN statement deter- 
mines whether either of the subroutines has been executed. If either 
flag has a value of one, the statement branches to RESET, where two SET 
FLAG statements set SSTEST to zero and assign its new value (zero) to 
TITEST. 


Note that the operands AND and OR allow a single TEST WHEN statement 
to perform the function of a sequence of statements. The statements in 
this example are equivalent to the following sequences: 


TEST WHEN, SSTEST,AND, TTTEST, ERROR: 


TEST WHEN, SSTEST,X 


GO TO,Y 
x TEST WHEN, TTTEST, ERROR 
Y ° 


TEST WHEN, SSTEST,OR, TTTEST, RESET: 


TEST WHEN, SSTEST, RESET 
TEST WHEN, TTTEST, RESET 


Testing on Arithmetic Conditions: Suppose that there is a processing 
loop that performs fixed-point calcuiations involving general register 7 


and a storage field named TEMP. According to the logic of the program, 
the value at TEMP should never exceed the value in register 7; if it 
does, an error has occurred, and dumps should be taken at LOOP+12. The 
following sequence shows a solution for this problem: 


Section 2: How to Write TESTRAN Statements 34.5 


TEST AT, LOOP+t12 
TEST WHEN, TEMP,GT,G'7',ERROR 
GO BACK 
ERROR DUMP COMMENT, ‘ERROR -- TEMP IS GREATER THAN G''7''.° 
DUMP DATA, TEMP 
DUMP PANEL,G‘'7' , DATAM=F 


TEMP DS F 


The TEST WHEN statement is the first statement executed at LOOP+12. It 
means: “When the vaiue at TEMP is greater than (GT) the value in general 
register 7 (G'7'), branch to ERROR." Appropriate dumps are taken if the 
branch is made; otherwise, control is returned to the program py the GO 
BACK statement. 


A TEST WHEN statement can be used to test an arithmetic condition 
involving any of the following: 


Values in main storage 
Values in registers 
TESTRAN counters 
Literal constants 


The condition must be expressed as a relationship between two values of 
the same data type and length, as, for example, two fulil-word:' fixed- 
point values. The relationship nust be expressed by one of the 
following special operands: 


GT - greater than 

GE - greater than or equal to 
EQ - equal to 

NE - not equal to 

LT - less than 

LE - less than or equal to 


The type and length of both values in a relationship is usually 
implied by the operand that represents the first value. Thus, in the 
relationship TEMP,GT,G'7', the operand TEMP implies fixed-point type and 
four-byte length, because TEMP is defined by a DS statement as a 
full-word fixed-point variable. If the relationship were expressed as 
G'7',LE,TEMP, four-byte length and hexadecimal type would be implied. 


If the first value is represented by an external reference or by an 
address that includes no symbols, the type and length are implied by the 
operand that represents the second value in the relationship. For 
example, if COUNT in the relationship 4(0,3),EQ,COUNT is a TESTRAN 
counter, it implies fixed-point type and four-byte length for the value 
at 4(0,3). 


Sometimes, it is necessary to specify type and length explicitly. 
For example, a reference to a value in a floating-point register implies 
a length of eight bytes. If the value is a short floating-point number, 
its true length can be specified as in the following statement: 


TEST WHEN, F'0',GE,F‘'4', CONTINUE, DATAM=E 
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The DATAM operand specifies the standard short floating-point type code 
E, which implies a length of four bytes, just as in a DS or DC 
statement. It might also be written as DATAM=DL4, thus specifying 
four-byte length for a long floating-point number. 


HOW TO OFFSET PROGRAM ERRORS 


Consider again the last example of the previous topic, "How to Test 
on Condition." In that example, a TEST WHEN statement was used to test 
a relationship between two values, and to branch to a sequence of DUMP 
statements if the relationship indicated an error condition. To offset 
the error condition, additional statements can be included in the 
sequence, as follows: 


UMP COMMENT, 'SET TEMP EQUAL TO G '. GO BACK TO NEXTSTEP 
SET VARIABLE, TEMP,G'T7' 





The DUMP COMMENT statement describes how the error is offset. The SET 
VARIABLE statement sets’ TEMP equal to the value in general register 7, 
eliminating the error condition as defined in the TEST WHEN statement. 
The GO BACK statement returns control to NEXTSTEP in the problem 
program, forcing an exit from the processing ioop that produced the 
error. 


This example shows two ways of offsetting a program error: 


e Using a SET VARIABLE statement to change problem program data. 
e Using a GO BACK statement to change prcklem program control flow. 


Neither way actuaily corrects the error; it simply provides an 
opportunity for additional testing by allowing execution to continue 
when it might otherwise be terminated. 


ff an error is successfully offset, execution may continue to normal 
completion, thus making it appear that there has not been an error. The 
DUMP COMMENT statement should therefore be used, as in the example, to 
call attention to any error that is detected, ana to describe the 
offsetting action by TESTRAN statements. 


Note that the SET VARIABLE statement in the example refers to two 
values, TEMP and G'7', and that these values have the same data type and 
length. Because the SET VARIABLE statement is equivalent to a move or 
load instruction, the length of the data to be moved or loaded is very 
important. It is determined in the same way that type and length are 
determined for values referred to by a TEST WHEN statement: it is either 
implied by one of the values, or is stated explicitly by a DATAM 
overand. Thus, to load a short floating-point number xX into a 
floating-point register, tne following statement might be written: 


SET VARIABLE, F'0',X, DATAM=L4 
The DATAM operand specifies a length of four bytes; if it were omitted, 
the operand F'0O' would imply a length of eight Lytes. 
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HOW TO CREATE TESTRAN SUBROUTINES 


Consider the following sequence of TESTRAN statements: 


TEST AT, (XX, YY, 22) 
DUMP CHANGES, MYDATA, MYDATA+100 


GO BACK 


In effect, this sequence is a closed subroutine that is called at the 
test points named in the TEST AT statement. When executed, it 
automatically returns control to the test point from which it was 
called. 


Suppose now that this subroutine should be executed at an additional 
test point, WW. At WW, its execution is to be followed by the execution 
of additional TESTRAN statements rather than by immediate return of 
control to the problem program. This subroutine should then be called 
as in the following sequence: 


TEST AT ,WW 





The first statements in this sequence form a new subroutine that is 
called at the test point WW. The new subroutine calls the original 
subroutine by means of a GO IN statement, which specifies X as an entry 
point. In the original subroutine, GO BACK is replaced by GO OUT, which 
returns to the statement that follows GO IN. Like GO BACK, the GO OUT 
Statement returns control to the problem program when the subroutine is 
called at XX, YY, or ZZ. 


As shown in Figure 4A, GO IN and GO OUT statements can be used to 
create up to three levels of TESTRAN subroutines. That is, the first 
subroutine called by a GO IN statement can call a second subroutine, and 
the second can call a third. In each subroutine, a GO OUT statement can 
be used to return to the subroutine at the next higher level. The third 
(lowest) level subroutine can thus return to the second level subrou- 
tine, the second to the first, and the first to the subroutine that made 
the original call (the closed subroutine that was entered directly from 
a test point). 
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GOIN, SI GOIN, 82 GOIN, $3 
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I ee a 


TESTRAN Subroutines 


Figure 4A. Calling and Returning from Three Levels of TESTRAN Subrou- 
tines 


If an attempt is made to create a fourth level subroutine, the 
ability to return from the first level subroutine is lost. In effect, 
the second level becomes the new first level, the third level becomes 
the new second level, and the newly created “fourth level" becomes the 
new third lievel. If a GO OUT statement is later executed at the old 
first level, control is returned to the proklem program. 


If a TESTRAN subroutine returns control to the problem program, 
existing subroutine levels cease to be recognized. At a later test 
point, new first, second, and third levels can be created, but old 
levels cannot be returned to. If an attempt is made to return to an old 
level by executing a GO OUT statement before executing a GO IN 
statement, control is returned to the problem program. 
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SECTION 3: HOW TO WRITE JOB CONTROL STATEMENTS 


To use TESTRAN, the programmer must write job control statements to 
define the job to be performed by the operating system. A typical 
TESTRAN job consists of one or more job steps, each of which performs one 
of the following functions: : 


e Assembly of the problem program 

e Linkage editing of the problem program 
e Execution of the problem program 

e Editing of test information 


The job control statements used in defining jobs and job steps are 
described in the publication IEM System/360 Operating System: Job Control 
Language. Statements for performing specific TESTRAN-oriented jobs are 
listed below. The jobs defined by these model job definitions include 
the following job steps: 


Assembly 

Linkage Editing 

Execution 

TESTRAN Editing 

Assembly and Linkage Editing 

Assembly, Linkage Editing, and Execution 

Assembly, Linkage Editing, Execution, and TESTRAN Editing 


Most of the model job definitions refer to IBM-supplied cataloged 
procedures, which are defined in Appendix B. Before attempting to use 
these procedures, the programmer should make certain that they have been 
included in the procedure library at his installation. If a procedure 
has been omitted, the programmer can copy the necessary statements from 
the appendix. 


ASSEMBLY 


Figure 5 defines a job that executes the E- or F-level assembler 
program. The statements in the figure are numbered, and are explained in 
the correspondingly numbered paragraphs below. The shaded statements are 
optional. 


JOB job parameters 
EXEC PROC=ASMxC, PARM=TEST 





DD data definition parameters 





Figure 5. Job Control Statements for Assembly 
1. This statement provides general job control information. 


2. This statement refers to one of two cataloged procedures, each of 
which defines a single job step, ASM. The PROC parameter specifies 
the procedure ASMEC to select the E-level assembler program, or the 
procedure ASMFC to select the F-level assembler program. The PARM 
parameter specifies the option TEST, which causes symbol tables to 
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be included in the object module; it also implies the following 
options: 


NOLOAD 

DECK 

LIST 

XREF ‘ 
LINECNT=standard line count 


If desired, other options can be specified in place of the implied 
options. The TEST option, however, must be specified. 


3. This statement is optional. If present, it saves the object module 
as a data set on a private magnetic tape or direct-access volume. 
The data set can subsequently be used as primary or additional input 
to the linkage editor. (If the data set is saved on a tape volume, 
the SPACE parameter can be omitted.) 


Statement 3 overrides the following statement in the procedure 
ASMEC: 


//SYSPUNCH DD UNIT=SYSCP 
or the following statement in the procedure ASMFC: 
//SYSPUNCH DD SYSOUT=B 


If the statement in the procedure is not overridden, it causes the 
object module to be produced as a deck of punched cards. 


4, This statement is optional. If present, its function is the same as 
that of statement 3, and it should therefore be written only if 
statement 3 is omitted. This statement is valid only with the 
procedure ASMFC, and only when the LOAD option is specified in the 
PARM parameter. 


5. This statement defines a data set that contains the source program 
to be assembled. This data set can appear in the input stream. 


LINKAGE EDITING 


Figure 6 defines a job that executes the largest linkage editor 
program available at the installation. The statements in the figure are 
numbered, and are explained in the correspondingly numbered paragraphs 
below. The shaded statements are optional. 


—_——— _ nee ee ee ere ee cere cs ce ee ee ee ee ee ae ee es oe ee ee oe ee ee es oe ee ee eS 
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1.|//jobnare JOB job parameters 
2. EXEC PROC=LKED, PARM=TEST 


Figure 6. Job Control Statements for Linkage Editing 


1. This statement provides general job control information. 
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This statement refers to a cataloged procedure named LKED, which 
defines a Single job step that is also named LKED. 


Region Size: Region size is the amount of main storage available to 
a job step that is executed under a system with MVT. The procedure 
LKED defines region size as 96K, which is the minimum required for 
the 88K version of linkage editor F. (Region requirements for other 
versions are given below.) A larger or smaller region can be 
requested by writing: 


REGION=nnnnnKk 


where nnnnn is a one- to five-digit decimal number specifying region 
size in units of K (1024) bytes. 


Linkage Editor Options: The PARM parameter specifies the option 
TEST, which causes symbol tables and object module control dic- 
tionaries to be included in the load module. Additional options 
that can be specified are: 


SCTR or OVLY 

DC 

OL 

LIST 

XREF or MAP 

NCAL 

LET or XCAL 

SIZE= (value, ,value,) 


Of these, LIST and XREF (which includes MAP) are diagnostic options, 
and NCAL and LET (which includes XCAL) are special processing 
options that are useful in testing a program. 


The SIZE option improves the performance of the F-level linkage 
editor by indicating the amount of available main storage (value,), 
and the size of the text buffer (valuez). The possibility of 
one-pass processing is enhanced if -the text buffer is at least as 
large as the load module to be created. 


Minimum value, is 6K; maximum is 100K. Minimum value, depends on 
value, and on the size of the linkage editor; maximum value, is 
9999K. The following table defines minimum value,, together with 
the region size required in systems with MVT: 


Freee ee I ee ee et a Sc aaa aca a 1 
| Size of the | | | 
| Linkage Editor | Minimum value, | MVT Region Size | 
| --------------------- 4--------------------- }---------------------- 
| 4uK | value2+3 8K | value,+10K | 

88K | valuest44K1 | value,+8K | 
| 128K | value2+t+ 66K? | value,+8K | 
ee ey eee Ne Oe en See eee Sone a a 


|*When values is less than 44K, minimum value, is 88K. | 


|27When values, is less than 66K, minimum value, is 128K. | 
Sea es Ne gE De rye sd Oe eR es EPPS roe EPA SIN ok Ry OR CRIT PEST | 


If the SIZE option is omitted, default values are used. These 
values are established at system generation. In a system with MVT, 
care must be taken to specify the correct region size based on 
default value,. 


Because the TEST option must be specified, the NE, REUS, RENT, and 


REFR options cannot be specified. The load module is therefore 
editable but not reusable or refreshable. 
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3. This statement is optional. If present, it saves the load module as 
a member of a partitioned data set (library) on a private direct- 
access volume. The data set may be new or may already exist; if it 
exists, the load module replaces any other member of the data set 
that has the same member name. (If the data set already exists, the 
DISP parameter can be omitted because DISP=(MOD,PASS) is specified 
in the cataloged procedure.) 


The load module can be referred to by its member name for subsequent 
execution aS a program or for reprocessing by the linkage editor. 
The saved load module should not be reprocessed, however, if the 
reprocessing involves replacing any non-TESTRAN control section with 
another control section of the same name. Such a control section 
would continue to be represented by the symbol tables and control 
dictionaries for the object module to which it originally belonged. 
Data recorded from this control section would therefore not be 
printed in the proper symbolic format. 


Statement 3 overrides the DSNAME, UNIT, and DISP parameters of the 
following statement in the procedure LKED: 


//SYSLMOD DD DSNAME=&GOSET (GO) , SPACE= (1024, (50,20,1)), 
// UNI T=SYSDA, DISP= (MOD, PASS) 


If these parameters are not overridden, they cause the load module 
to be produced as a member of a temporary data set that is deleted 
at the end of the job. 


4.\ These statements define the input to the linkage editor. Statement 
4 defines the primary input, which is a data set containing one or 
more object modules, or linkage editor control statements, or both. 


Statement 5 is optional. If present, it defines either an included 
data set or an automatic call library. It can be repeated as 
necesSary to define any number of input data sets. 


Sequentially organized data sets can appear in the input’ stream. 
However, in a system with the primary control program, only one data 
set can appear in the input stream, and it must be defined by the 
last DD statement for the step LKED. 


EXECUTION 


Figure 7 defines a job that executes a program for testing by the 
TESTRAN interpreter. The statements in the figure are numbered, and are 
explained in the correspondingly numbered Petagraphs below. The shaded 
statements are optional. 


JOB jcb parameters 


DD  DSNAME=dsname,DISP=(NEW,KEEP), Continue 
UNIT=t ype,, VOLUME= (PRIVATE, SER=ser#) , SPACE= (300, (200,50) ) 
ib) SOUT 








Figure 7. Job Control Statements for Execution 
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1. This statement provides general job control information. 


2. This statement is optional. If present, it points to a private load 
module library that is to be used as the job library. If this 
library has been cataloged, the UNIT and VOLUME parameters should be 
omitted. 


3. This statement refers to a load module that is a member of either 
the system link library or the job library. 


4. This statement saves the output of the TESTRAN interpreter as a data 
set on a private magnetic tape or direct-access volume. This data 
set can subsequently be referred to for processing by the TESTRAN 
editor. (If the data set is saved on a tape volume, the SPACE 
parameter can be omitted.) 


The data set contains test information resulting from the execution 
of a Single task. In a system with a primary control program or 
MFT, there is only one task per job step; only one data set is 
required, and this statement need appear only once. In a system 
with MVT, there may be many tasks per job step; this statement must 
be repeated (with varying ddnames) as many times as necessary to 
define a separate data set for each task. 


The name of the DD statement for each data set is determined by the 
first TEST OPEN statement executed under the corresponding task. 
The TEST OPEN statement either implies the ddname SYSTEST, or 
specifies a ddname by means of a DDN operand. 


5. This statement is optional. If present, it defines a data set to 
contain an abnormal termination dump. To limit this dump to problem 
program areas, the ddname SYSABEND can be changed to SYSUDUMP. 


6. This statement is optional. If present, it defines a data set that 
is used by the problem program. It can be repeated as necessary to 
define any number of data sets. 


Sequentially organized input data setsS can appear in the input 
stream. dowever, in a system with the primary control program, only 
one data set can appear in the input stream, and it must be defined 
by the last DD statement for the job step. 


TESTRAN EDITING 


Figure 8 defines a job that executes the TESTRAN' editor. The 
statements in the figure are numbered, and are explained in the 
correspondingly numbered paragraphs below. 


//jobname JOB ‘job parameters 
«| 77 EXEC PROC=TTED 


//EDIT.SYSTEST DD DSNAME=dsname, DISP=OLD, Continue 
// UNIT= (type, SEP=SYSUT1) , VOLUME= (PRIVATE, SER=ser#) 





Figure 8. Job Control Statements for TESTRAN Editing 
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This statement provides general job control information. 


This statement refers to a cataloged procedure named MTTED, which 
defines a single job step named EDIT. 


TESTRAN Editor Options: Three options can be specified by a PARM 
parameter written as: 


PARM= [*] [Ta]... [Pb] 


increases the speed of TESTRAN editing by a factor of four. At 
the same time, it increases main storage requirements from 18K 
bytes to 50K bytes. If present, it must occupy the first 
position in the parameter. 


In a system with MVT, the * option should always be specified. 
The procedure TTED provides a 50K byte region, which is wasted 
if the option is not specified. 


Ta 

identifies a class of test information that is to be edited. 
The value a is either an unsigned decimal integer from 1 to 8, 
a blank, or the letter A. If an integer, it is ae class 
identification number specified by a SELECT keyword operand in 
one or more TEST OPEN, TEST AT, DUMP, or TRACE statements. If 
a blank, it indicates that all unclassified data is to be 
edited. If the letter A, it indicates that all data is to be 
edited, regardless of classification. 


The subfield Ta can be repeated as many times as necessary to 
select all desired information for processing during a _ single 
execution of the TESTRAN editor. Note that if a class of 
information is not selected, and has not previously been 
edited, the input TESTRAN data set should be saved to allow 
later editing of this information. 


If the subfield Ta is omitted, all information is printed as if 
TA were specified. 


Pb 
specifies the maximum number of pages to be printed. The value 
b is an unsigned decimal integer. It must not be greater than 


the maximum page count established at the installation during 
system generation. 


If the subfield Pb is omitted, the maximum count is as 
specified in the first TEST OPEN statement executed under the 
task that created the data set. If this TEST OPEN statement 
did not specify a maximum, the installation maximum is assumed. 


This statement defines the input TESTRAN data set, which contains 
the test information to be edited. 


If all information is to be edited (rather than just selected 
classes), the disposition can be changed to DISP=(OLD,DELETE). It 
is safest, however, to keep the data set until printed output has 
actually been returned. The data set can then be deleted, if it is 
on a tape volume, by instructing the operations staff to scratch the 
tape; if it is on a direct-access volume, it can be deleted by use 
of the IEHPROGM utility program. For information on how to use 
IEHPROGM, refer to the publication IBM System/360 Operating System: 
Utilities. . 


ASSEMBLY AND LINKAGE EDITING 


Figure 9 defines a job that executes the largest assembler and linkage 
editor available at the installation. The statements in the figure are 
numbered, and are explained in the correspondingly numbered paragraphs 
below. The shaded statements are optional. 


-{//jobname JOB jcb parameters 
//stepname EXEC PROC=TASME 





Figure 9. Job Control Statements for Assembly and Linkage Editing 
1. This statement provides general job control information. 


2. This statement refers to a cataloged procedure named TASME, which 
defines two job steps: ASM and LKED. 


Region Size: kKegion size is the amount of main storage available to 
a job step that is executed under a system with MVT. The procedure 
TASME defines region size for the job steps ASM and LKED. 


For the step LKED, the procedure defines region size as 96K, which 
is the minimum required for the 88K version of linkage editor F. 
(For the region requirements of other versions, refer to "Linkage 
Editor Options.") A larger or smaller region can be requested by 
writing: 


REGION. LKED=nnnnnk 


where nnnnn is a one- to five-digit decimal number specifying region 
size in units of K (1024) bytes. 


Assembler Options: The following assembler options are specified or 
implied in the cataloged procedure: 


TEST 

NOLOAD 

DECK 

LIST 

XREF 

LINECNT=standard line count 


The TEST option is required to cause symbol tables to be included in 
the object module; the others are standard default options. NOLOAD 
and DECK indicate that the object module is to be stored on an 
external storage device. (Refer to paragraphs 3 and 4.) LIST and 
XREF are diagnostic options useful in program testing. 


Section 3: How to Write Job Control Statements 41 


42 


The default options can be overridden by writing: 
PARM.ASM= (TEST,overriding options) 
where the overriding options are any of the following: 


LOAD 
NODECK 
NOLIST 
NOXREF 
LINECNT=nn 


where nn is an unsigned decimal integer from 1 to 99. Any default 
option not overridden remains in effect. The TEST option, because 
it is not a default option, must be explicitly specified. 


Linkage Editor Options: The following linkage editor options are 
specified in the cataloged procedure: 


TEST 
LIST 
XREF 
NCAL 
LET 


The TEST option is required to cause symbol tables and object module 
control dictionaries to be included in the load module. LIST and 
XREF are diagnostic options; NCAL and LET are special processing 
options that are useful in testing a program. 


These options can be respecified by writing: 
PARM.LKED= (TEST,respecified options) 
where the respecified options are any of the following: 


SCTR or OVLY 

DC 

OL 

LIST 

XREF or MAP 

NCAL 

LET or XCAL 

SIZE= (value, , values) 


Each of the original options (TEST, LIST, XREF, NCAL, and LET) is 
overridden if it is not respecified. Because the TEST option must 
be respecified, the NE, REUS, RENT, and REFR options cannot be 
specified. 


The SIZE option improves the performance of the F-level linkage 
editor by indicating the amount of available main storage (value,), 
and the size of the text buffer (value.,). The possibility of 
one-pass processing is enhanced if the text buffer is at least as 
large as the load module to be created. 


Minimum value, is 6K; maximum is 100K. Minimum value, depends on 
value, and on the size of the linkage editor; maximum value, is 
9999K. The following table defines minimum value,, together with 
the region size required in systems with MVT: 


paee aS 
| Size of the 


| Linkage Editor 


| 44k value,+38K value,+10K | 
| 88K valuej+44K1 value,+8K | 
| 128K value j+66K2 value,+8K | 
Pee ee eee a eae ee ee Meee ee hte 4 


|*When value, is less than 44K, minimum value, is 88K. | 
|2When value, is less than 66K, minimum value, is 128K. | 


If the SIZE option is omitted, default values are used. These 
values are established at system generation. In a system with MVT, 
care nust be taken to specify the correct region size based on 
default value,. 


This statement is optional, but, if it is written, statement 6 must 
also be written. The two statements together save the object module 
produced by the assembler as a data set on a private magnetic tape 
or direct-access volume. This data set can later be used as primary 
or additional input to the linkage editor. 


Statements 3 and 6 override the DSNAME, UNIT, and DISP parameters of 
the following statements in the procedure TASME: 


//SYSPUNCH DD DSNAME=&LOADSET,UNIT=SYSDA, 
// SPACE= (80, (200,50) ) , DISP= (MOD, PASS) 
//SYSLIN DD DSNAME=§LOADSET, DISP= (OLD, DELETE) 


If these parameters are not overridden, they cause the object module 
to be produced as a temporary data set in direct-access' storage. 
This data set is deleted at the end of the job. 


If statements 3 and 6 are present, statement 5 must appear between 
them in the sequence. If statement 4 is also present, it must 
appear between statements 3 and 5. 


This statement is optional. If present, it produces a copy of the 
object module as a deck of punched cards. This statement is valid 
only for the F-level assembler, and is recognized only when LOAD is 
specified as an overriding option in statement 2. 


This statement defines the data set that contains the source program 
to be assembled. This data set can appear in the input stream. 


Refer to paragraph 3 above. 


This statement is optional. If present, it saves the load module as 
a member of a partitioned data set (library) on a private direct- 
access volume. The data set may be new or may already exist; if it 
exists, the load module replaces any other member of the data _ set 
that has the same member name. (If the data set already exists, the 
DISP parameter can be omitted because DISP=(MOD,PASS) is specified 
in the cataloged procedure.) 


The load module can be referred to by its member name for later 
execution aS a program or for reprocessing by the linkage editor. 
The saved load module should not be reprocessed, however, if the 
reprocessing involves replacing any non-TESTRAN control section with 
another control section of the same name. Such a control section 
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would continue to be represented by the symbol tables and control 
dictionaries for the object module to which it originally belonged. 
Data recorded from this control section would therefore not be 
printed in the proper symbolic format. 


Statement 7 overrides the DSNAME, UNIT, and DISP parameters of the 
following statement in the procedure TASME: 


//SYSLMOD DD DSNAME=§GOSET (GO) , SPACE= (1024, (50,20, 1)), 
11 UNIT=SYSDA, DISP= (MOD, PASS) 


If these parameters are not overridden, they cause the load module 
to be produced as a member of a temporary data set that is deleted 
at the end of the job. 


a These statements are optional. If present, they define input to 
the linkage editor. 


Statement 8 defines a data set to be concatenated with the primary 
input to the linkage editor. (The primary input is the object 
module produced by the assembler; refer to paragraph 6 above.) 


Statement 9 defines either an included data set or an automatic call 
library. It can be repeated as necessary to define any number of 
input data sets. 


Sequentially organized data setS can appear in the input stream. 
However, in a system with the primary control program, only one data 
set can appear in the input stream, and it must be defined by the 
last DD statement for the step LKED. 


ASSEMBLY, LINKAGE EDITING, AND EXECUTION 


Figure 10 defines a job that executes the largest assembler and 
linkage editor available at the installation, and the load module 
produced by the linkage editor. The statements in the figure are 
numbered, and are explained in correspondingly numbered paragraphs below. 
The shaded statements are optional. 


//jobnare JOB job parameters 


ti td 
UNIT=type, VOLUME= (PRIVATE, SER= 





Figure 10. Job Control Statements for Assembly, Linkage Editing, and 
Execution 
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This statement provides general job control information. 


This statement is optional. If present, it points to a private load 
module library that is to be used as the job library. If this 
library has been cataloged, the UNIT and VOLUME parameters should be 
omitted. 


This statement refers to a cataloged procedure TASMEG that defines 
three job steps: ASM, LKED, and GO. 


Region Size: Region size is the amount of main storage available to 
a job step that is executed under a system with MVT. The procedure 
TASMEG defines the region size of each job step except the problem 
program job step, GO. For GO, the default region size is assumed. 


For the step LKED, the procedure defines region size as 96K, which 
is the minimum required for the 88K version of MJlinkage editor F. 
(For the region requirements of other versions, refer to "Linkage 
Editor Options.") A larger or smaller region can be requested by 
writing: 


REGION. LKED=nnnnnk 


where nnnnn is a one- to five-digit decimal number specifying region 
size in units of K (1024) bytes. 


For the job step GO, a region larger than the default region size 
can be requested by writing: 


REGION. GO=nnnnnk 


Assembler Options: The following assembler options are specified or 
implied in the cataloged procedure: 


TEST 

NOLOAD 

DECK 

LIST 

XREF 

LINECNT=sStandard line count 


The TEST option is required to cause symbol tables to be included in 
the object module; the others are standard default options. NOLOAD 
and DECK indicate that the object module is to be stored on an 
external storage device. (Refer to paragraphs 4 and 5.) LIST and 
XREF are diagnostic options useful in program testing. 


The default options can be overridden by writing: 
PARM.ASM= (TEST,overriding options) 
where the overriding options are any of the following: 
LOAD 
NODECK 
NOLIST 
NOXREF 
LINECNT=nn 
where nn is an unsigned decimal integer from 1 to 99. Any default 


option not overridden remains in effect. The TEST option, because 
it is not a default option, must be explicitly specified. 
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Linkage Editor Options: The following linkage editor options are 
specified in the cataloged procedure: 


TEST 
LIST 
XREF 
NCAL 
LET 


The TEST option is required to cause symbol tables and object module 
control dictionaries to be included in the load module. LIST and 
XREF are diagnostic options; NCAL and LET are special processing 
options that are useful in testing a program. 


These options can be respecified by writing: 
PARM. LKED= (TEST, respecified options) 
where the respecified options are any of the following: 


SCTR or OVLY 

DC 

OL 

LIST 

XREF or MAP 

NCAL 

LET or XCAL 

SIZE= (value, ,valueg) 


Each of the original options (TEST, LIST, XREF, NCAL, and LET) is 
overridden if it is not respecified. Because the TEST option must 
be respecified, the NE, REUS, RENT, and REFR options cannot be 
specified. 


The SIZE option improves the performance of the F-level linkage 
editor by indicating the amount of available main storage (value,) , 
and the size of the text buffer (values). The possibility of 
one-pass processing is enhanced if the text buffer is at least as 
large as the load module to be created. 


Minimum value, is 6K; maximum is 100K. Minimum value, depends on 
value, and on the size of the linkage editor; maximum value, is 
9999K. The following table defines minimum value,, together with 
the region size required in systems with MVT: 


(ee ar == fase oe oe ree 5 se ea amma ae aid 7 
| Size of the | | | 
| Linkage Editor | Minimum value, | MVT Region Size | 
}--------—--~--------- }---------—-----—--—- 4-----------—---------- 
| 44K | valuegt+38K | value,+10K | 

88K | valuez2t44K1 | value,+8K | 
| 128K | valuezt66K2 | value,t+8K | 
es a ees ee ee 


}7When value, is less than 44K, minimum value, is 88K. | 
|2When values is less than 66K, minimum value, is 128K. | 


If the SIZE option is omitted, default values are _ used. These 
values are established at system generation. In a system with MVT, 
care must be taken to specify the correct region size based on 
default value,. 


Problem Program Information: Information can be passed to the 
problem program by writing: 


PARM. GO= (xxx...) 
where xxx... is the information. 


This statement is optional, but, if it is written, statement 7 must 
aiso be written. The two statements together save the object module 
produced by the assembler as a data set on a private magnetic tape 
or direct-access volume. This data set can later be used as primary 
or additional input to the linkage editor. 


Statements 4 and 7 override the DSNAME, UNIT, and DISP parameters of 
the following statements in the procedure TASMEG: 


//SXYSPUNCH DD DSNAME=&LOADSET, UNIT=SYSDA, 
11 SPACE= (80, (200,50) ) , DISP= (MOD, PASS) 
//SYSLIN DD DSNAME=§LOADSET, DISP= (OLD, DELETE) 


If these parameters are not overridden, they cause the object module 
to be produced as a temporary data set in direct-access storage. 
This data set is deleted at the end of the job. 


If statements 4 and 7 are present, statement 6 must appear between 
them in the sequence. If statement 5 is also present, it must 
appear between statements 4 and 6. 


This statement is optional. If present, it produces a copy of the 
object module as a deck of punched cards. This statement is valid 
only for the F-level assembler, and is recognized only when LOAD is 
specified as an overriding option in statement 3. 


This statement defines a data set that contains the source program 
to be assembled. This data set can appear in the input stream. 


Refer to paragraph 4 above. 


This statement is optional. If present, it saves the load module as 
a member of a partitioned data set (library) on a private direct- 
access volume. The data set may be new or may already exist; if it 
exists, the load module replaces any other member of the data set 
that has the same member name. (If the data set already exists, the 
DISP parameter can be omitted because DISP=(MOD,PASS) is specified 
in the cataloged procedure.) 


The load module can be referred to by its member name for later 
execution as a program or for reprocessing by the linkage editor. 
The saved load module should not be reprocessed, however, if the 
reprocessing involves replacing any non-TESTRAN control section with 
another control section of the same name. Such a control section 
would continue to be represented by the symbol tables and control 
dictionaries for the opject module to which it originally belonged. 
Data recorded from this control section would therefore not be 
printed in the proper symbolic format. 


Statement 8 overrides the DSNAME, UNIT, and DISP parameters of the 
following statement in the procedure TASMEG: . 


//SYSLMOD DD DSNAME=§GOSET (GO) , SPACE= (1024, (50,20,1)), 
// UNLT=SY SDA, DISP= (MOD, PASS) 
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If these parameters are not overridden, they cause the load module 
to be produced as a member of a temporary data set that is deleted 
at the end of the job. 


These statements are optional. If present, they define input to 
the linkage editor. 


Statement 9 defines a data set to be concatenated with the primary 
input to the linkage editor. (The primary input is the object 
module produced by the assembler; refer to paragraph 7 above.) 


Statement 10 defines either an included data set or an automatic 
call library. It can be repeated as necessary to define any number 
of input data sets. 


Sequentially organized data setS can appear in the input stream. 
However, in a system with the primary control program, only one data 
set can appear in the input stream, and it must be defined by the 
last DD statement for the step LKED. 


This statement saves the output of the TESTRAN interpreter as a data 
set on a private magnetic tape or direct-access volume. This data 
set can subsequently be referred to for processing by the TESTRAN 
editor. (If the data set is saved on a tape volume, the SPACE 
parameter can pe omitted.) 


The data set contains test information resulting from the execution 
of a single task. In a system with a primary control program or 
MET, there is only one task per job step; only one data set is 
required, and this statement need appear only once. Ina system 
with MVT, there may be many tasks per job step; this statement must 
be repeated (with varying ddnames) as many times as necessary to 
define a separate data set for each task. 


The name of the DD statement for each data set is determined by the 
first TEST OPEN statement executed under the corresponding task. 
The TEST OPEN statement either implies the ddname SYSTEST, or 
specifies a ddname by means of a DDN operand. 


This statement is optional. If present, it defines a data set to 
contain an abnormal termination dump. To limit this dump to problem 
program areas, the ddname SYSABEND can be changed to SYSUDUMP. 


This statement is optional. If present, it defines a data set that 
is used by the problem program. It can be repeated as necessary to 
define any number of data sets. 


Sequentially organized input data sets can appear in the input 
stream. However, in a system with the primary control program, only 
one data set can appear in the input stream, and it must be defined 
by the last DD statement for the step GO. 


ASSEMBLY, LINKAGE EDITING, EXECUTION, AND TESTRAN EDITING 


Figure 11 defines a job that executes the largest assembler and 
linkage editor available at the installation, the load module produced by 
the linkage editor, and the TESTRAN editor. The statements in the figure 
are numbered, and are explained in the correspondingly numbered para- 
graphs below. The shaded statements are optional. 


Ge ee ea Sa ig es eine Gay ae oa oe ss mee Ig ee I ee ea LOPES eT Re Ca dae yr weet 


// jobname job parameters 
— 


data definition parameters 


//GO.ddname DSNAME=dsname, DISP= (NEW, KEEP) , UNIT=type, 





eFigure 11. Job Control Statements for Assembly, Linkage Editing, Execu- 
tion, and TESTRAN Editing 


1. This statement provides general job control information. 


2- This statement is optional. If present, it points to a private load 
module library that is to be used as the job library. If this 
library has been cataloged, the UNIT and VOLUME parameters should be 
omitted. 


3. This statement refers to a cataloged procedure TASMEGED that defines 
four job steps: ASM, LKED, GO, and EDIT. The COND parameter 
specifies that EDIT is to be executed even if a previous job step 
terminates abnormally. As a result, the output of: the TESTRAN 
interpreter is always edited, even after abnormal termination of the 
job step that produces the output. 


Region Size: Region size is the amount of main storage available to 
a job step that is executed under a system with MVT. The procedure 
TASMEGED defines the region size of each job step except the problem 
program job step, GO. For GO, the default region size is assumed. 


For the step LKED, the procedure defines region size as 96K, which 
is the minimum required for the 88K version of linkage editor F. 
(For the region requirements of other versions, refer to “Linkage 
Editor Options.") A larger or smaller region can be requested by 
writing: 


REGION. LKED=nnnnnk 
where nnnnn is a one- to five-digit decimal number specifying region 


Size in units of K (1024) bytes. 
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For the job step GO, a region larger than the default region size 
can be requested by writing: 


REGION. GO=nnnnnk 


Assembler Options: The following assembler options are specified or 
implied in the cataloged procedure: 


TEST 

NOLOAD 

DECK 

LIST 

XREF 

LINECNT=standard line count 


The TEST option is required to cause symbol tables to be included in 
the object module; the others are standard default options. NOLOAD 
and DECK indicate that the object module is to be stored on an 
external storage device. (Refer to paragraphs 4 and 5.) LIST and 
XREF are diagnostic options useful in program testing. 


The default options can be overridden by writing: 
PARM.ASM= (TEST,overriding options) 
where the overriding options are any of the following: 


LOAD 
NODECK 
NOLIST 
NOXREF 
LINECNT=nn 


where nn iS an unsigned decimal integer from 1 to 99. Any default 
option not overridden remains in effect. The TEST option, because 
it is not a default option, must be explicitly specified. 


Linkage Editor Options: The following linkage editor options are 
specified in the cataloged procedure: 


TEST 
LIST 
XREF 
NCAL 
LET 


The TEST option is required to cause symbol tables and object module 
control dictionaries to be included in the load module. LIST and 
XREF are diagnostic options; NCAL and LET are special processing 
options that are useful in testing a program. 


These options can be respecified by writing: 
PARM.LKED= (TEST, respecified options) 
where the respecified options are any of the following: 


SCTR or OVLY 

DC 

OL 

LIST 

XREF or MAP 

NCAL 

LET or XCAL 

SIZE= (value, , value.) 


Each of the original options (TEST, LIST, XREF, NCAL, and LET) is 
overridden if it is not respecified. Because the TEST option must 
be respecified, the NE, REUS, RENT, and REFR options cannot be 
specified. 


The SIZE option improves the performance of the F-level linkage 
editor by indicating the amount of available main storage (value,), 
and the size of the text buffer (valuez). The possibility of 
one-pass processing is enhanced if the text buffer is at least as 
large as the load module to be created. 


Minimum valuez iS 6K; maximum is 100K. Minimum value, depends on 
value, and on the size of the linkage editor; maximum value, is 
9999K. The following table defines minimum value,, together with 
the region size required in systems with MVT: 
ha Se Se a ae ee 1 
| Size of the | | | 
| Linkage Editor | | MVT Region Size | 
}--------------------- }--------------------- {---------------------- { 
| | | 

| | 

| | 


foo nn 


44k valueszt38K value,+10K | 
88K valuest+44K1 value,+8K | 
| 128K valuez+t 66K2 value, +8K | 
Bla ae ee ee ee eed 


{7When value, is less than 44K, minimum value, is 88K. | 
|}2When value, is less than 66K, minimum value, is 128K. | 


If the SIZE option is omitted, default values are _ used. These 
values are established at system generation. In a system with MVT, 
care must be taken to specify the correct region size based on 
default value,. 


Problem Program Information: Information can be passed to the 
problem program by writing: 


- PARM.GO= (xxx...) 
where xxx... is the information. 
TESTRAN Editor Options: Two options can be specified by a PARM 
parameter written as: 
PARM. EDIT= [*] [Ta] ... [Pb] 
increases the speed of TESTRAN editing by a factor of four. At 
the same time, it increases main storage requirements from 18K 


bytes to 50K bytes. If present, it must occupy the first 
position in the parameter. 
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In a system with MVT, the * option should always be specified. 
The procedure TASMEGED provides a 50K byte region, which is 
wasted if the option is not specified. 


Ta 

identifies a class of test information that is to be edited. 
The value a is either an unsigned decimal integer from 1 to 8, 
a blank, or the letter A. If an integer, it is a class 
identification number specified by a SELECT keyword operand in 
one or more TEST OPEN, TEST AT, DUMP or TRACE statements. If a 
blank, it indicates that all unclassified data is to be edited. 
If the letter A, it indicates that all data is to be edited, 
regardless of classification. 


The subfield Ta can be repeated as many times as necessary to 
select all desired information for processing during a single 
execution of the TESTRAN editor. Note that if a class of. 
information iS not selected, and has not’ previously been 
edited, the input TESTRAN data set should be saved to allow 
later editing of this information. 


If the subfield Ta is omitted, all information is printed as if 
TA were specified. 


Pb 
specifies the maximum number of pages to be printed. The value 
b is an unsigned decimal integer. It must not be greater than 
the maximum page count established at the installation during 
system generation. . 


If the subfield Pb is omitted, the maximum count is as 
specified in the first TEST OPEN statement executed under the 


task that created the data set. If this TEST OPEN statement — 


did not specify a maximum, the installation maximum is assumed. 


This statement is optional, but, if it is written, statement 7 must 
also be written. The two statements together save the object module 
produced by the assembler as a data set on a private magnetic tape 
or direct-access volume. This data set can later be used as primary 
or additional input to the linkage editor. 


Statements 4 and 7 override the DSNAME, UNIT, and DISP parameters of 
the following statements in the procedure TASMEGED: 


//SYSPUNCH DD DSNAME=&LOADSET, UNIT=SYSDA, 
// SPACE= (80, (200,50) ) ,DISP= (MOD, PASS) 
//SYSLIN DD DSNAME=6LOADSET, DISP= (OLD, DELETE) 


If these parameters are not overridden, they cause the object module 
to be produced as a temporary data set in direct-access storage. 
This data set is deleted at the end of the job. 


If statements 4 and 7 are present, statement 6 must appear between 
them in the sequence. If statement 5 is aiso present, it must 
appear between statements 4 and 6. 


This statement is optional. If present, it produces a copy of the 
object module as a deck of punched cards. This statement is valid 
only for the F-level assembler, and is recognized only when LOAD is 
Specified as an overriding option in statement 3. 


This statement defines a data set that contains the source program 
to be assembled. This data set can appear in the input stream. 


Refer to paragraph 4 above. 


11. 


This statement is optional. If present, it saves the load module as 
a member of a partitioned data set (library) on a private direct- 
access volume. The data set may be new or may already exist; if it 
exists, the load module replaces any other member of the data set 
that has the same member name. (If the data set already exists, the 
DISP parameter can be omitted because DISP=(MOD,PASS) is specified 
in the cataloged procedure.) 


The load module can be referred to by its member name for later 
execution aS a program or for reprocessing by the linkage editor. 
The saved load module should not be reprocessed, however, if the 
reprocessing involves replacing any non-TESTRAN control section with 
another control section of the same name. Such a control _ section 
would continue to be represented by the symbol tables and control 
dictionaries for the object module to which it originally belonged. 
Data recorded from this control section would therefore not be 
printed in the proper symbolic format. 


Statement 8 overrides the DSNAME, UNIT, and DISP parameters of the 
following statement in the procedure TASMEGED: 


//SYSLMOD DD DSNAME=§GOSET (GO) , SPACE= (1024, (50,20,1)), 
// UNIT=SYSDA, DISP= (MOD, PASS) 


If these parameters are not overridden, they cause the load module 
to be produced as a member of a temporary data set that is deleted 
at the end of the job. 


These statements are optional. If present, they define input to 
the linkage editor. 


Statement 9 defines a data set to be concatenated with the primary 
input to the linkage editor. (The primary input is the object 
module produced by the assembler; refer to paragraph 7 above.) 


Statement 10 defines either an included data set or an automatic 
call library. It can be repeated as necessary to define any number 
of input data sets. 


Sequentially organized data sets can appear in the input stream. 
However, in a system with the primary control program, only one data 
set can appear in the input stream, and it must be defined by the 
last DD statement for the step LKED. 


This statement saves the output of the TESTRAN interpreter as a data 
set on a private magnetic tape or direct-access volume. This data 
set can subsequently be referred to for processing by the TESTRAN 
editor. (If the data set is saved on a tape volume, the SPACE 
parameter can be omitted.) 


The data set contains test information resulting from the execution 
of a single task. In a system with a primary control program or 
MFT, there is only one task per job step; only one data set is 
required, and this statement need appear only once. In a system 
with MVT, there may be many tasks per job step; this statement must 
be repeated (with varying ddnames) as many times as necessary to 
define a separate data set for each task. 
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12. 


13. 


14. 
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The name of the DD statement for each data set is determined by the 
first TEST OPEN statement executed under the corresponding task. 
The TEST OPEN statement either implies the ddname SYSTEST, or 
specifies a ddname by means of a DDN operand. 


If SYSTEST is specified or implied as a ddname, the SYSTEST DD 
statement is optional. If present, this statement must precede all 
other DD statements for the job step GO, and should be written as: 


//GO.SYSTEST DD DSNAME=dsname,DISP= (NEW,KEEP) , 
// . -UNIT=type, VOLUME= (PRIVATE, RETAIN, SER=Ser #) 


This statement overrides the DSNAME, UNIT, and DISP parameters of 
the following statement in the procedure TASMEGED: 


//SYSTEST DD DSNAME=&TESTSET, SPACE= (300, (200,50)), 
// UNIT=SYSSQ, DISP= (NEW, PASS) 


If these parameters are not overridden, they define a temporary data 
set that is either on magnetic tape or in direct-access' storage. 
This data set is deleted at the end of the job. 


This statement is optional. If present, it defines a data set to 
contain an abnormal termination dump. To limit this dump to problem 
program areas, the ddname SYSABEND can be changed to SYSUDUMP. 


This statement is optional. If present, it defines a data set that 
is used by the problem program. It can be repeated as necessary to 
define any number of data sets. 


Sequentially organized input data sets can appear in the input. 
stream. However, in a system with the primary control program, only 
one data set can appear in the input stream, and it must be defined 
by the last DD statement for the step GO. 


This statement points to a TESTRAN data set that contains TESTRAN 
interpreter output to be processed by the TESTRAN editor. It should 
be present if: 


e Statement 11 overrides the statement SYSTEST in the cataloged 
procedure, or 


e SYSTEST is not specified or implied as a ddname in a TEST OPEN 
statement. 


Otherwise, statement 14 should be omitted, because it overrides the 
DSNAME and DISP parameters of the following statement in the 
procedure TASMEGED: 


//SYSTEST DD DSNAME=&TESTSET, UNIT=SYSSQ,SEP=SYSUT1, 
// DISP= (OLD, DELETE) 


If these parameters are not overridden, they refer to a temporary 
data set that is created by the TESTRAN interpreter, processed by 
the TESTRAN editor, and deleted at the end of the job. 


15. 
16. 


Statement 14 can be written only once. Any data set that is defined 
by statement 11 but is not referred to by statement 14 cannot be 
edited under the procedure TASMEGED. Such a data set can be edited 
under another procedure, TTED, which is invoked by writing two 
optional statements, 15 and 16. 


If all of the information in a data set is to be edited (rather than 
just selected classes), the disposition in statement 14 can be 
changed to DISP=(OLD,DELETE). It is safest, however, to keep the 
data set until printed output has actually been returned. The data 
set can then be deleted, if it is on a tape volume, by instructing 
the operations staff to scratch the tape; if it is on a direct- 
access volume, it can be deleted by use of the IEHPROGM utility 
program. For information on how to use IEHPROGM, refer to the 


publication IBM System/360 Operating System: Utilities. 


These statements are optional. If present, they define a job step 
that edits a TESTRAN data set defined by statement 11 but not 
referred to by statement 14. The two statements together can be 
repeated to define a number of job steps equal to the number of data 
sets that are to be edited. 


Statement 15 refers to a cataloged procedure named TTED, which 
defines a job step named EDIT. The COND parameter specifies that 
this step is to be executed even if a previous step terminates 
abnormally. TESTRAN editor options can be specified as in statement 


Statement 16 points to the TESTRAN data set that is to be edited. 
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SECTION 4: HOW TO INTERPRET SYSTEM OUTPUT 


Every TESTRAN job produces system output that includes listings of 
job control statements and of certain data sets. The control statements 
include both those in the input stream and those in cataloged procedures 
that are invoked in the input stream. The data sets are those to which 
the job control statements assign a SYSOUT disposition. 


Typical system output data sets are abnormal termination dumps and 
the listings produced by the assembler, the linkage editor, and the 
TESTRAN editor. This section describes only the last listing; the 
others are described in the publications: 


IBM System/360 Operating System: Programmer's Guide to Debugging 
IBM System/360 Operating System: Assembler (E) Programmer's Guide 
IBM System/360 Operating System: Assembler (F) Programmer's Guide 
IBM System/360 Operating System: Linkage Editor 


Interpreting a TESTRAN Listing: Test information 1s printed on _ the 
system output device in a column 120 characters wide. Each page 
includes a standard page heading and an average of 55 lines of 
information produced by one or more TESTRAN statements. The general 
format of a page is shown by the. sample page in Figure 12. 


The circled numbers in Figure 12 distinguish five basic formats for 
individual lines of print. These are as follows: 


1. ..-TESTRAN OUTPUT... heads each page. 


2. AT LOCATION... indicates entry to the TESTRAN interpreter at a 
test point. 


3. ..-MACRO ID... indicates one of the following: 


e Execution of a DUMP, TRACE, TEST OPEN, or TEST CLOSE statement. 
e Output resulting from an executed TRACE statement. 
¢ Detection of an error following execution of a statement. 


4, EXECUTED STATEMENTS,... traces execution of GO, SET, TEST ON, and 
TEST WHEN statements. 


5. *** IEGE... indicates a diagnostic message from the TESTRAN 
editor. 


Each of these formats is described in detail in the remainder of this 
section. 


The printing formats for specific types of data are shown in Table 1. 
The letters used to represent printing formats in the table are used 
with the same meanings throughout the remainder of this section. In 
addition, the letter y is used to designate a printed character for 
which the data type is variable. 
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®@ 
® 


© ©O OOO OO © OOO 


Jo81 TESTRAN OUTPUT DATE 10/164 TIME 10/04 PAGE 


1) MACRO ID 000, TEST OPEN » TESTRAN CONTROL SECTION = BEGIN » IDENTIFICATION JOBL 
AT LOCATION (SYMALTER) OOOOEC OLOOEC ENTER BEGIN 
EXECUTED STATEMENTS, BEGIN 003 


2) MACRO I0 005, DUMP DATA STARTING IN SECTION SYMALTER 
0154 INAREA 
010154 COMEBACK MVC WRITAREA(88) ,ENTER CLEAR BUFFER FOR NEXT CARD 0003 


4) MACRO ID 006, DUMP PANEL 
G04" 00010154 G*08" OOOLOOFC 
PSW 00 0 1 0002 0 0 O1008C CC=0 FIX POINT OVERFLOW OFF OEC OVERFLOW OFF EXP UNDERFLOW OFF 


EXECUTED STATEMENTS, BEGIN 007, 008 


1) MACRO ID 014, OUMP DATA STARTING IN SECTION SYMALTER 
OoFs ERRFLAG STARTIN STARTO 
OLOOFS * 


AT LOCATION RETURNI (SYMALTER) OOOODA O1O00A ENTER BEGIN 
EXECUTED STATEMENTS, BEGIN 010 


3) MACRO ID 012, OUMP DATA STARTING IN SECTION SYMALTER 


OOFC OUTAREA 
OLOOFC COMEBACK MVC WRITAREA(88) ,ENTER CLEAR BUFFER FOR NEXT CARD 0003 
EXECUTED STATEMENTS, BEGIN O13 


1) MACRO [D 014, OUMP DATA STARTING IN SECTION SYMALTER 
OOFS8 ERRFLAG STARTIN STARTO 
OLOOF8 e 1 


ees TEGEO? END OF TESTRAN EOIT~-0000005 STATEMENTS PROCESSE 


Figure 12. TESTRAN Editor Listing: Sample Page 
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SIGNIFICANCE OFF 


1 


Table 1. Printing Formats for Data Types 


Pe te tna eg a eee pee Te ee TS Sai re ee 1 
| jAssumed Length | | 
| jin Bytes {Printing Format | 
|Data Type | (1) | (2) | 
~+-~~~----——----~-----—— fanaa nnn - fo 
| Character | 1 Jc | 
J (3) | | | 
~----------~------------- }------------------ fro----- == ~~ === == { 
| Hexadecimal | 1 | xx | 
-----——--—~——------- }------------------ {----~-----~--------------- { 
| Binary | 1 | bbbbbbbb | 
}-----------—-—----------- $--------——--------- }--------~=---------------- { 
-[|Fixed-point (half-word) | Z | sddddd | 
| | | (4) | 
}~------------------------- }------------------ }~-----~------------------- { 
|Fixed-point (full-word) | 4 | sdddddddddd | 
| | | GA) | 
j-------------------~----- }~----—------------ | --------~~-~-------------- { 
[Short floating-point | 4 |s0.dddddddd Esdd | 
aan == ponnnn nnn nna f= 
[Long floating-point | 8 |s0.dddddddddddadddd Esdd_ | 
~~----------------------- }~-----------------} --------------=--=--------4 
|Packed decimal | 1 |sd | 
~---~-------------------- }------------------ }-2------------------------ { 
| Zoned decimal | < jsd | 
~~----------------------- }------------------}--------------------------| 
| Address | | | 
{ 5) | | | 
~------------------------ }------------------ {----~--------~------------ { 
| Instruction: | | | 
| RR format | 2 Jcccc xx | 
|} RS, RX, and SI formats | 4 jcccc XX K XXX | 
| SS format | 6 |cccc xX K XXX X XXX | 
Pea ees A eee Pe eee oe ae ee a ee ve sey ot ru depeeg Serpe ties eee J 


Notes to Table 1 


1. 


The lengths assumed in definitions of printing formats are the 
assembler implied lengths for the corresponding data types. (Refer 
to Appendix A, Table 5.) 


The letters shown in definitions of printing formats have the 
following meanings: 


is one EBCDIC character. 

is one hexadecimal digit. 

is one binary digit. 

is an algebraic sign (+ or -). 

is one decimal digit. 

is a high order zero. 

means ‘exponent'; the succeeding signed pair of digits is the 
exponent of the floating-point number. 

cccc is a machine mnemonic operation code. 


Boananxnna 


Unprintable characters (other than blanks) are printed as_ two 
hexadecimal digits, the second of which appears on a separate line 
immediately below the first. For example, the hexadecimal data 
C1D3D7C8C103C4C1E3C1 
when edited into character format, is printed as 
ALPHAODATA 
3 
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4. This format includes a decimal point that is positioned according to 
the scale factor associated with the data. 


5. All addresses are printed in their source language formats. 


PAGE HEADING (...TESTRAN OUTPUT...) 


The following heading is printed at the top of each page: 


nn eee 1 
| ceecccce TESTRAN OUTPUT DATE dd/ddd TIME dd/dd PAGE dddd | 
Ma cs se ae ee ee ce ne ce me ee ee sa mec i me ce 00 we a ee ee ae me a ce ane a re ee a ec ae a ee ee 4 
ecccccecce 


is the output identification specified as the third positional 
operand of the first-executed TEST OPEN statement. 


DATE dd/ddd 
is the current date (year/day). 


TIME dd/dd 
is the time (hour/minute) at which editing was begun. 


PAGE dddd 
is the output page number. 


TEST POINT IDENTIFICATION (AT LOCATION...) 


The following line indicates entry to the TESTRAN interpreter at a 
test point: 


AT LOCATION cccceccc(cccccecc) xxxxxX XXXXxXxX 
identifies the test point. The field cccccccc(cccccccc) identifies 
the test point by name (if any), and by name (if any) of the control 
section that contains the test point. The fields xxxxxx xxxxxx are 
the assembled and loaded addresses of the test point. 


ENTER ccccccce 
identifies the TESTRAN control section in which the test point was 
specified. (The control section is defined by an identically named 
TEST OPEN statement, as indicated in the assembly listing by message 
number IEGMO4.) 


Note: The SELECT operand does not affect printing of the AT- LOCATION 
line. This line is omitted, however, if it is not followed by the output 
of a DUMP or TRACE statement, or by an error message. 


STATEMENT OUTPUT (...MACRO ID...) 


Statement output is all output that is identified by "MACRO ID". It 
includes TEST OPEN, TEST CLOSE, DUMP and TRACE statement output, and 
error messages issued by the TESTRAN interpreter. Specific types of 
statement output are described below. 
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DUMP CHANGES OUTPUT 


DUMP CHANGES output is a change dump of main storage whose format is 
the same as that described below under “DUMP DATA Output." 


DUMP COMMENT OUTPUT 


The following lines are a dump of a programmer-written comment. 


| . d) MACRO ID ddd, DUMP COMMENT | 
CCCCC. ee 


is the class number assigned to the dump by a SELECT operand. 


MACRO ID ddd, DUMP COMMENT 
identifies the statement responsible for the dump. The identifi- 
cation number ddd is assigned by the assembler, and appears with the 
statement in the assembly listing (message number IEGMO9). 


C6CCE. ws 
is the dumped comment, which has a maximum length of 120 characters. 


DUMP DATA OUTPUT 


The following lines are a dump of main storage: 


| d) MACRO ID ddd, DUMP DATA STARTING IN SECTION ccececcce | 
| XXxXX ceceeccce eccccecc cccececc : | 
| XXXXXX YYYYYYYYYYYYY-++ YYYYYYYYYYYYY--- YYYYYYYYYyyyy--- | 


d) 
is the class number assigned to the dump by a SELECT operand. 


MACRO ID ddd, DUMP CHANGES 
identifies the statement responsible for the dunip. The identifi- 
cation number ddd is assigned by the assembler, and appears with the 
statement in the assembly listing (message number IEGM09). 


STARTING IN SECTION cccccccc 
identifies the control section that contains the dumped data. 


XXXX 
XXXXXX 
are the assembled and loaded addresses of a dumped field. The field 
is the first fieid printed to the right of these addresses. 


ccccccce 
YYYYYYYYYYYYY--: 
are the symbolic name (if any) and contents of a dumped field. The 
name and format of the field are as defined in the problem program, 
or as specified by NAME and DATAM operands. 


Section 4: How to Interpret System Output 53 


Note: The number of named fields per line varies from one to eleven due 
to differences in length; the starting positions are a minimum of nine 
printing positions apart. Fields too long for the current line are 
started on a new line. 


In a dump of an instruction sequence, an instruction may be printed 
with the instruction SVC 26 immediately beneath it. If so, the 
instruction is located at a test point; the SVC instruction is the means 
by which the test point gives control to the TESTRAN interpreter. The 
Svc instruction replaced the original instruction when the test point was 
established; the original instruction was saved for execution on return 
of control to the test point. 


DUMP MAP OUTPUT 


The following lines are a map of control sections and allocated 
storage areas associated with a task that is active when a DUMP MAP 
statement is executed. 


(Ras SSS Se Se eS ees =SS eS eer ae eee 1 
| a) MACRO ID ddd, DUMP MAP | 
| NAME TYPE CSECT NAME ASSEMBLED AT LOADED AT LENGTH=DEC HEX | 
| ecececce ‘LOADED PROGRAM ecceccce XXXXXX XXXXXX dddad xxXX | 
| OBTAINED STORAGE XXXXXX dddd XxX | 
be a ee a a Sa a a a ae a aa a Se Ss a ee ee ee ee eS j 


is the class number assigned to the dump Ey a SELECT operand. 


MACRO ID ddd, DUMP MAP 
identifies the statement responsible for the dump. The identifi- 
cation number ddd is assigned by the assembler, and appears with the 
statement in the assembly listing (message number IEGM09). 


NAME 
is a column heading. The column identifies each program (load 
module) associated with the active task. Each program is represent- 
ed by one line of print for each of its control secticns. In a 
given line, the name cccccccc of a program is printed only if 
different from the name that applies to the previous line. 


TYPE 
is a column heading. The column indicates the type of storage area 
that is represented. LOADED PROGRAM indicates a control section for 
which storage was reserved during assembly. OBTAINED STORAGE 
indicates an allocated storage area. . 


CSECT NAME 
-is a column heading. The column identifies each control section of 
each program associated with the active task. 


ASSEMBLED AT 
is a column heading. The column contains the assembled address of 
each control section named in the dump. 


LOADED AT 
is a column heading. The column contains the loaded address of each 
control section named in the dump. It also contains the address of 
each allocated storage area. 


LENGTH-DEC HEX 
is a double column heading. The double column defines the decimal 
and hexadecimal length of each control section and allocated storage 
area. 
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Note: Some of the areas included in the dump will be areas allocated for 
use by the operating system. 


DUMP PANEL OUTPUT 


The following lines are a dump of registers and the program status 
word. 


1 
la MACRO ID ddd, DUMP PANEL | 
G'dd* xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx | 
G'dd* xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx G'dd" xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx G'dd' xxxxxxxx 
| PSW xX X X XXxXX X X XxXxxxx CC=d FIX POINT OVERFLOW ccc DEC OVERFLOW ccc EXP UNDERFLOW ccc SIGNIFICANCE ccc | 
| F'dd@' xxxxxxxx xxxxxxxx F'dd' xxxxxxxx xxxxxxxx F'dd'! xxxxxxxx xxxxxxxx F'dd!' xxxxxxxX XXxXXXXXX | 

4 


is the class number assigned to the dump by a SELECT operand. 


MACRO ID ddd, DUMP PANEL 
identifies the statement responsible for the dunip. The identifi- 
cation number ddd is assigned by the assembler, and appears with the 
statement in the assembly listing (message number IEGM09). 


G'dd* xxxxxxxx 
is the number (dd) and contents (xxxxxxxx) of a dumped general 
register. The contents of the register are either in hexadecimal 
format as shown, or in some other format as specified by a DATAM 
operand. 


PSW XX X XXXX X K XXXXXX 
is the program status word (PSW) stored on interruption of the 
problem program at the current test point. 


cc=d 
specifies the value of the condition code (bits 34 and 35 of the 
program status word). 


FIX POINT OVERFLOW ccc 
specifies the status of the fixed-point overflow mask (bit 36 of the 
program status word). The status ccc is either ON or OFF. 


DEC OVERFLOW ccc 
specifies the status of the decimal overflow mask (bit 37 cf the 
program status word). The status ccc is either ON or OFF. 


_EXP UNDERFLOW ccc 
specifies the status of the exponent underflow mask (bit 38 of the 
program status word). The status ccc is either ON or OFF. 


SIGNIFICANCE ccc 
specifies the status of the significance mask (pit 39 of the program 
Status word). The status ccc is either ON or OFF. 


F'dd* xxXxXxXxXXXX XXKKXXXX 
is the number (dd) and contents (xxxxxxxx XXXXxXxxx) of a dumped 
floating-point register. The contents of the register are either in 
hexadecimal format as shown, or in some other format as specified by 
a DATAM operand. 
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DUMP TABLE OUTPUT 


The following lines are a dump of a system table (control block). 


| d) MACRO ID ddd, DUMP TABLE ccce cccecee BLOCK LOADED AT cccccecc(ecccccec) xxxxxx XXXxXxX 
| SECTION FIELD NAME CONTENTS 
|: eececcec 


cecccecc_—-yyyyy... 


is the class number assigned to the dump by a SELECT operand. 


MACRO ID ddd, DUMP TABLE 
identifies the statement responsible for the dump. The identifi- 
cation number ddd is assigned by the assembler, and appears with the 
statement in the assembly listing (message number IEGMO09). 


eccece ccecccecce BLOCK 
identifies the dumped table as a task control block, data control 
block, or data extent block. 


LOADED AT cccecccec(ceccccccc) xxxxxx XXxXxXXxX 

specifies the location of a task control block or data control 
block. The field cccccccc(cccccccc) specifies the name (if any) of 
a data control block and the name (if any) of the control section 
that contains the data control block. A single field xxxxxx 
specifies the address of a task control biock; two fields xxxxxx 
XXXXXX Specify both the assembled and loaded addresses of a data 
control block. 


SECTION 
is a column heading. The column identifies major sections of the 
table. 


FIELD NAME 
is a column heading. The column identifies fields within major 
sections of the table. 


CONTENTS 
is a column heading. The column defines the contents of each field. 


ERROR MESSAGE 


The following lines indicate detection of an error during execution of 
a TESTRAN statement. 


. @) MACRO ID ddd, ERROR 
| *** = =TIEGIdd ccccc... | 


is a class number assigned by a SELECT operand. 


MACRO ID ddd, ERROR 
identifies the statement that caused or detected the error. The 
identification number ddd is assigned by the assembler and appears 
with the statement in the assembly listing (message number IEGM09). 
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*** TEGIdd ccccc... 
is an error message issued by the TESTRAN interpreter. The text of 
the message (ccccc...) is preceded by a standard system message 
code (IEGIdd). For an explanation of the message, refer to Appendix 
Cc, where all messages issued by the interpreter are listed in order 
by message code. 


TEST CLOSE OUTPUT 


The following lines indicate the execution of a TEST CLOSE statement. 


| da) MACRO ID add, TEST CLOSE | 
ceccecece (cccccccc) XxXxxxxX XXXXXX ... 


cae ee Ge ee eS Shee etait ieee 4 
da) 
is the class number specified by the SELECT operand (if any) of a 
TEST OPEN statement. 


MACRO ID ddd, TEST CLOSE 
identifies the TEST CLOSE statement. The identification number dda 
is assigned by the assembler and appears with the statement in the 
assembly listing (message number IEGMO9). 


ceccccccc(cccccccc) XXXXxXX XKXKXXX 

identifies a TESTRAN control section closed by the TEST CLOSE 
statement. The field cccccccc(cccccccc) contains a symbol generated 
during assembly and the name of the TESTRAN control section. The 
fields xxxxxx XxxXxxXxx are the assembled and loaded addresses of the 
control section. (The control section is defined by an identically 
named TEST OPEN statement, as indicated in the assembly listing by 
message number IEGMO4.) 


Note: The SELECT operand does not affect the printing of these lines of 
information. 


TEST OPEN OUTPUT 


The following lines indicate the execution of a TEST OPEN statement. 


r 

| da) MACRO ID ddd, TEST OPEN » TESTRAN CONTROL SECTION = cccccecc, IDENTIFICATION ccecccce | 
| MAXIMUM NUMBER OF PAGES ddd, MAXIMUM NUMBER OF STATEMENTS ddd 

L 


is the class number specified by the SELECT operand (if any) of the 
TEST OPEN statement. 


MACRO ID ddd, TEST OPEN , TESTRAN CONTROL SECTION = cccccccc 

identifies the TEST OPEN statement. The identification number ddd 
is assigned by the assembler and appears with the statement in the 
assembly listing (message number IEGM09). The name of the TESTRAN 
control section (cccccccc) is also the name of the TEST OPEN 
Statement. (The control section is defined by the TEST OPEN 
statement, aS indicated in the assembly listing by message number 
TEGMO4.) 
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IDENTIFICATION cccccccc 
specifies the output identification as provided by the third 
positional operand of the TEST OPEN statement. 


MAXIMUM NUMBER OF PAGES ddd 
specifies the maximum number of pages produced. 


MAXIMUM NUMBER OF STATEMENTS ddd 
specifies the maximum number of executed TESTRAN statements. 


Note: The SELECT operand does not affect the printing of these lines of 
information. 


TRACE CALL OUTPUT 


The following groups of lines indicate the execution of a TRACE CALL 
Statement and the later execution of a CALL macro-instruction. 


rn re 1 
| d) MACRO ID ddd, TRACE CALL , cceccccc, FROM cceccece (ccececce) xxxxxx xxxxxx TO ccceecee (ccccccce) xxxxxx XXXXXX | 
| STARTED 

| ecccec... : | 
| da) MACRO ID ddd, TRACE CALL , cccccccc, TO ccceceec(cecececc) xxxxxx xxxxxx -AT cececeec(cccccccc) xxxxxx xxXxxxxX | 
| G'dd' xxxxxxxx ... | 

G'dd' xxxxxxxx ... 

| eccce... . | 
A a a ae SS es ee Se te ee ee J 


is the class number assigned to the trace by a SELECT operand. 


MACRO ID ddd, TRACE CALL , cccccccc, 

identifies the statement responsible for the trace. The identifi- 
cation number ddd is assigned by the assenibler, and appears with the 
statement in the assembly listing (message number IEGMO9). The 
field cccccccc is the name of the TESTRAN control section to which 
the statement belongs. (The control section is defined by an 
identically named TEST OPEN statement, as indicated in the assembly 
listing by message number IEGMO4.) 


FROM ccccccece(cccccccc) xXxxxxx xxXxXxxx TO ccccccce (cccccccc) xxxxxxk XXXXXX 
defines the trace area. FROM cccccccc(cccccccc) specifies the name 
(if any) of the leftmost byte of the area and the name (if any) of 
the control section to which it belongs. TO cceccccce(cccccccc) 
gives the same information for the rightmost byte plus one. The 
fields xxxxxx Xxxxxx are the corresponding assembled and loaded 
addresses. 


TO ccccceccc(cccccccc) xxxXxxxX XKXxXxXx AT cccccccc(cccccccc) xxxKxxK XXXXXX 

identifies a called subroutine and the calling macro-instruction. 
TO cccccccc(cccccccc) specifies the name (if any) of the subroutine 
entry point, and the name (if any) of the control section that 
contains the entry point. FROM cccccccc(cccccccc) specifies the 
name (if any) of the CALL macro-instruction and the name (if any) of 
the control section that contains the CALL macro-instruction. The 
fields xxxxxx xxxxxx are the corresponding assembled and loaded 
addresses. 


G'dd" xxxxxxxx 


gives the number (dd) and contents (xxxxxxxx) of a general register 
used by the CALL macro-instruction. 
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CCCCes:«). 
is a comment specified by a COMMENT operand (if any) in the TRACE 
CALL statement. The maximum length is 120 characters. 


TRACE FLOW OUTPUT 


The following groups of lines indicate the execution of a TRACE FLOW 
Statement and the later execution of a branch or SVC instruction. 


[a 1 
| d) MACRO ID ddd, TRACE FLOW , ccccccec, FROM ccceeccee (cccececc) xxxxxx xxxxxx TO ccccccce(cccccecc) xxxxxx xXxXXKXX | 
| STARTED : | 
| ccccec... | 
| d) MACRO ID ddd, TRACE FLOW , cccccccc, FROM ccececcc(ccceccce) xxxxxx xxxxxx TO ccccecec(cccccccec) xxxxxx xxxxxx, CC=d | 
| cccce XX X XXX G'dd" xxxxxxxx ... | 
ecccc... | 
| a) MACRO ID ddd, TRACE FLOW , cccccccc, FROM cccccece(ccccccce) xxxxxx xxxxxx TO cceccece (ccccccce) xXxxxxx xXxxxxx, CC=d | 
| ecce xX X XXX EXECUTED AS cccc xx X XXX BY EX xx x xxx FROM LOCATION ccccccce(cccccccc) xxxxxx xxxxxx | 
| G'dd' xxxxxxxxX ... | 
CCCCC. ee 
Ma a Se ea a Se a a ee a aS ee a ee d 


is the class number assigned to the trace by a SELECT operand. 


MACRO ID ddd, TRACE FLOW , cccccccc, 

identifies the statement responsible for the trace. The identifi- 
cation number ddd is assigned by the assembler and appears with the 
statement in the assembly listing (message number IEGM09). The 
field cccccccc is the name of the TESTRAN control section to which 
the statement belongs. (The control section is defined by an 
identically named TEST OPEN statement, as indicated in the assembly 
listing by message number IEGM04.) 


FROM ccccecece(cccecccc) xXxXXxXxxX XxXxXxxx TO cccccccc(cccccccc) xxxKxXxXX XXXXXX 
either (1) defines the trace area, or (2) identifies an executed 
branch or SVC instruction and the branch destination: 


1. FROM cccccccc(cccccccc) specifies the name (if any) of the 
leftmost byte of the trace area, and the name (if any) of the 
control section to which it belongs. TO cccccccce (cccccccc) 
gives the same information for the rightmost byte plus. one. 
The fields xxxxxx xxxxxx are the corresponding assembled and 
loaded addresses. 


2. FROM cccccccc(cccccccc) specifies the name (if any) of an 
executed branch or SVC instruction, and the name (if any) of 
the control section that contains the instruction. TO 
cccccccc(cccccccc) specifies the name (if any) of the branch 
destination, and the name (if any) of the control section that 
contains the destination. The fields xxxxxx xxxxxx are the 
corresponding assembled and loaded addresses. 


Ccc=da 
specifies the value of the condition code when the branch or SVC 
instruction is executed. 


CcCcCC XX X XXX 


is the branch or SVC instruction. (If an RR-type instruction, it is 
printed as cccc xx.) 
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EXECUTED AS cccc XX X XXX BY EX XX X XXX 
indicates execution of a branch or SVC instruction by an EX 
instruction (EX xx x xxx). The instruction as executed is cccc xx x 
xxx (or cccc xx if it is an RR-type instruction). The effective 
values of bits 8-15 are shown. 


FROM LOCATION ccccccce(cccccccc) Xxxxxx XXXXXX 
specifies the location of the EX instruction. The field 
cceccccecc(cccccccc) specifies the name (if any) of the EX instruction 
and the name (if any) of the control section that contains the 
instruction. The fields xxxxxx xxxxxx are the assembled and loaded 
addresses of the EX instruction. 


G'dd* xxxxxxxx 
gives the number (dd) and contents (xxxxxxxx) of a general register 
‘used by a branch or EX instruction. 


CCCccCess 
is a comment specified by a COMMENT operand (if any) in the TRACE 
FLOW statement. The maximum length is 120 characters. 


TRACE REFER OUTPUT 


The following groups of lines indicate the execution of a TRACE REFER 
Statement and the later execution of a reference to data. 


nn rn nr rt rn rrr rere er re 1 

| d) MACRO ID ddd, TRACE REFER , cccececc, FROM cececece(ccccecec) xxxxxx xxxxxx TO cccecccec(ccecccce) xxxXxXxXxX XXXXXX 

| srarTep | 

| ecccc... | 

| d) MACRO ID ddd, TRACE REFER , cccececcc, TO ceccecec(ceecceee) xxxxxx xxxxxx FROM ceceecece (ccececec) xxxxxx xxXxxxxX | 

| ecce xx X Xxx x xxx G'dd' xxxxxxxx ... ; | 

| cccce... 

| BEFORE yyyyy... AFTER YYYYY--. 4 

| da) MACRO ID ddd, TRACE REFER , cccccccc, TO ccececce(cccecccc) xxxxxx xxxxxx FROM cecccece(ccececcc) xxxxxx xXxxxxx | 
eccce xx X Xxx X XxX EXECUTED AS cccc xx x xxx x xxx BY EX xX X xxx FROM LOCATION ccecccece(cceccccc) xxxxxx xxXxxxXX 

| G'ad! xxxxxxxx ... | 
eccce... 

| BEFORE” yyyyy... AFTER yyyyy.-. | 

Poe See ee eee ea See a eae ee ee ee ea ee J 


is the class number assigned to the trace by a SELECT operand. 


MACRO ID ddd, TRACE REFER , cccccccc, 

identifies the statement responsible for the trace. The identifi- 
cation number ddd is assigned by the assembler and appears with the 
Statement in the assembly listing (message number IEGM09). The 
field cccccccc is the name of the TESTRAN control section to which 
the statement belongs. (The control section is defined by an 
identically named TEST OPEN statement, as indicated in the assembly 
listing by message number IEGMO04.) 


FROM ccccccce(cccccccc) xxxxxx xxxxxx TO cccccccc(cccccccc) xXxxxxK XKXKXX 
defines the trace area. FROM cccccccec(cccccccc) specifies the name 
(if any) of the leftmost byte of the area and the name (if any) of 
the control section to which it belongs. TO cccccecce (cccccccc) 


gives the same information for the rightmost byte plus. one. The. 
fields xxxxxX xXxXxXxxx are the corresponding assenbled and loaded, 
addresses. 
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TO cccceccecc(cccccccc) xXxXxxxKxX XXXxKxXxX FROM cccccccc(cccccccc) xxxxxxK XxXxXxXXx 
identifies a field to which a reference is made and the instruction 
making the reference. TO cccccccc(cccccccc) specifies the name (if 
any) of the field and the name (if any) of the control section that 
contains the field. FROM cccccccc(cccccccc) specifies the name (if 
any) of the instruction making the reference and the name (if any) 
of the control section that contains the instruction. The fields 
XXXXKXX XKXXxXxK are the corresponding assembled and loaded addresses. 


cccc XX X XXX X XXX 
is the instruction making the reference. (If an RS-, RX-, or 
SI-type instruction, it is printed as cccc xx x xxx.) 


EXECUTED AS cccc XK X XXX X XXX BY EX xx X Xxx 
indicates that the instruction making the reference is executed by 
an EX instruction (EX xx x xxx). The instruction as executed is 
cccc XX X XXX xX xxx (or cccc xx xX xxx if it is an RS-, RX-, or 
SI-type instruction). The effective values of bits 8-15 are shown. 


FROM LOCATION cccccccce(cccccccc) xxxxxKxX XXXXKXX 
specifies the location of the EX instruction. The field 
ccccccc(cccccccc) specifies the name (if any) of the control secticn 
that contains the instruction. The fields xxxxxx xxxxxx are the 
assembled and loaded addresses cf the EX instruction. 


G'dd‘ xxxxxxxx 
gives the number (dd) and contents (xxxxxxxx) of a general register 
used by the instruction making the reference, or by an EX instruc- 
tion. 


CCCCcc... 
is a comment specified by a COMMENT operand (if any) in the TRACE 
REFER statement. The maximum length is 120 characters. 


BEFORE yyyyy.-e- 
specifies the contents of the field before the reference. 


AFTER VVVVYee- 
specifies the contents of the field after the reference. 


TRACE STOP OUTPUT 


The following line indicates execution of a TRACE STOP statement. 


(rrr rn ree 1 
da) MACRO ID ddd, TRACE STOP ccccccce ddd, ddd, ..., cccccccc ddd, ddd, ... | 
bseionooo we eee ee a ae Sa ee ee eae ee ae ee ae a Se J 


is the class number assigned by a SELECT operand. 


MACRO ID ddd, TRACE STOP 
identifies the TRACE STOP statement. The identification number ddd 
is assigned by the assembler and appears with the statement in the 
assembly listing (message number IEGM09). 


ceecccce ddd, ddd,«.s 
identifies TRACE statements referred to by the TRACE STOP statement. 
Each number ddd is the identification number of a TRACE statement in 
a TESTRAN control section cccccccc. Each identification number is 
assigned by the assembler and appears with a statement in the 
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assembly listing (message number IEGM09). Each TESTRAN' control 
section is defined by an identically named TEST OPEN statement 
(message number IEGM04). 


Note: If the TRACE STOP statement does not refer to other statements 
by name, the word ALL is printed to indicate that all traces are 
stopped. 


TESTRAN STATEMENT TRACE (EXECUTED STATEMENTS...) 


The following line traces execution of GO, SET, TEST ON, and TEST WHEN 
statements. 


| EXECUTED STATEMENTS, ccccccce ddd, ddd, ..., ccccccce ddd, ddd, ... | 


ccccccce ddd, ddd,... 
identifies the executed statements. Each number ddd is the iden- 
tification number of a statement in a TESTRAN control section named 
cccccccc. Each identification number is assigned by the assembler 
and appears with a statement in the assembly listing (message number 
IEGM09). Each TESTRAN control section is defined by an identically 
named TEST OPEN statement (message number IEGMO4). 


Note: This line is printed only if followed by the output of a DUMP or 
TRACE statement, or by an error message. The number of statements 
identified is limited to 28: the first 27 statements that are executed 
and the last statement that is executed before other output is generated. 





TESTRAN EDITOR MESSAGE (*#** IEGE...) 


The following line is a diagnostic message issued by the TESTRAN 
editor. 


Dp a Rg ng OP re ae ee age ne eet as cae Pe ge eg ee mg ge ee Peer on Ge eae a 1 
| *##* = €6TEGEdd ccccc... ! 
{ | 
Dee eee a ea ee Bee es a Se aS Se a a eh ee en dj 
IEGEdd 


is a message code that identifies the message. 
CCCCCsss 


is the message text. For an explanation of the text, refer to 
Appendix C, which lists all messages in order by message code. 
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APPENDIX A: 


This 
function 


appendix formally describes the 
and format of TESTRAN statements. 


CODING CONVENTIONS 


TESTRAN statements are 
to the coding conventions for assembler 
language macro-instructions. These conven- 
tions are described in the publication IBM 
Systen/360 Operating System: Assembler Lan- 
quage. They should be familiar to the 
reader who has experience in writing his 
Own macro-instructions or in using those 
defined by the system for requesting super- 
visor and data management services. 


coded according 


The coding of macro-instructions differs 
in two ways from the coding of machine 
instructions: 


1. There is no limit to the number of 
continuation lines that can be used. 

2. There is a wider variety of operands. 

For the reader who has no experience 

with macro-instructions, the following 


brief description of the operand field may 
be helpful. 


The Operand Field: As in a machine 
instruction, the operand field consists of 


individual operands that are separated by 
commas. The meaning of each operand either 
is implied by its position in the field or 
is expressed by a keyword that is 
the operand itself. For example, 
statements 


the three 


DUMP DATA, CHANGES, DATAM=L8, SELECT=1 
DUMP DATA, CHANGES, SELECT=1, DATAM=L8 
DUMP CHANGES, DATA, SELECT=1, DATAM=L8 


each contain two positional operands fol- 
lowed by two keyword operands. Because the 
position of a keyword operand is unimpor- 
tant, the first two statements are func- 
tionally equivalent; they are not equival- 
ent to the third statement, which differs 
in its first and second (positional) oper- 
ands. 


Some operands are optional: they can be 


written or omitted as the programmer 
chooses. If a positional operand is omit- 
ted, it must be represented by a comma if 


it precedes a positional operand that is 
not omitted. In the statement 


TEST ON,,,2,EVEN 


part of. 
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the second and third operands are omitted 
and each is represented by a comma. An 
omitted positional operand is not rep- 
resented by a comma if it is not followed 
by a positional operand that is actually 
written. An omitted keyword operand is 
never represented by a comma. 


To allow the use of commas within an 
operand, a positional operand or the right- 
hand part of a keyword operand can some- 
times be enclosed in parentheses. Within 
the parentheses, commas separate individual 
items of information, which together are 
called a sublist. In the statements 


Til TRACE STOP, (TRACE#1, TRACE#2, TRACE#3 ) 
D1 DUMP DATA, INPUT, INPUT+80 ,DSECT= (INPUT, 3) 


the second (positional) operand of T1 is a 
sublist of three items, and the DSECT 
keyword operand in Di contains a sublist of 
two items. The number of items in a 
sublist is variable; the programmer speci- 
fies one or nore items as he chooses. If 
only one item is specified, no commas are 
needed to separate items and the enclosing 
parentheses can be omitted. 


FUNCTIONS OF TESTRAN STATEMENTS 


The following pages describe the func- 
tions of TESTRAN statements and their oper- 
ands. For convenience, the statements are 
divided into four groups: 


DUMP and TRACE statements. 
TEST statements. 

GO statements. 

SET statements. 


The description of each group has two 


parts: 


°e A list of the statements in the group 
and the general function of each state- 
ment. 


e A list of the operands for the _ state- 
ments and the specific function of each 
operand. 

To use this part of the appendix, turn 
to the last part, "Format of TESTRAN State- 
ments," and fold out the last page to show 

Tables 2-5. Table 2 defines the format of 

TESTRAN statements using conventions that 

are standard in the Systems Reference 

Library. Tables 3-5 present supplementary 
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information akout the format of certain 


operands. 


To write a statement uSing this appen- 
dix, first select a statement from the list 


DUMP AND TRACE STATEMENTS 


The DUMP and TRACE statements record 
information about the problem program. 
Their basic functions are as follows: 


DUMP DATA 
dumps a storage area. 

DUMP CHANGES 
dumps changes to a storage area; 
dumped fields are printed only if (1) 
contained in the first dump taken by’ 
the statement, or (2) contained in a 
later dump and changed since the pre- 
vious dump by the same statement. 

DUMP COMMENT 
dumps a programmer's comment contained 
in the statement. 

DUMP MAP 
dumps a map of control sections and 
allocated storage areas associated 
with the active task. 

DUMP PANEL : 
dumps general and floating-point reg- 
isters and the program status word 
stored at the most recent interruption 
of the problem program. 

DUMP TABLE 
dumps a specified system table 
(control block). 

TRACE CALL 
traces subroutine calls by CALL macro- 
instructions in a specified storage 
area. 

TRACE FLOW 
traces transfers (by branch and svc 
instructions) to, from, or within a 


storage area. 


TRACE REFER 
traces references to a storage area by 
instructions that could change data 
within that area. 


TRACE STOP 
stops traces started by TRACE CALL, 
TRACE FLOW, and TRACE REFER 
statements. 
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of statements for one of the groups. Refer 
to the tables on the foldout page to learn 
the format of the statement. Then refer to 
the list of operands for a description of 
each operand indicated in the takles. 


eee 


Operands: The operands of the DUMP and 
TRACE statements are as follows: 


address 

e as the second operand, points to the 
leftmost byte of a storage area. 

e as the third operand, points to the 
rightmost byte plus one of a storage 
area, with this exception: in a DUMP 
TABLE statement, the third operand 
points to the data control block 
(DCB) that is dumped or that is 
associated with the data extent 
block (DEB) that is dumped. 


Note on Storage Areas: A storage area 
is defined by the effective values of 


the address operands at the time a 
DUMP or TRACE statement is executed. 
Indexing of addresses may cause an 
area to vary in size and location when 
a statement is executed several times 
(i.e., at several test points). A 
change dump of a variakle area 
includes all additions tc the pre- 
viously dumped area, plus changed data 
that lies within both the present and 
previous areas. A trace is shifted 
from the previously defined area to a 
newly defined area on each execution 
of the statement that first started 
the trace. 


If a statement does not point to both 
ends of a storage area, the length of 
the area is determined by the DATAM 
keyword operand. If this operand is 
omitted, the length is determined by 
the length attribute of the first 
symbol used in the address. If the 
address contains no symbols, or only 
an external symbol, the length is 
assumed to be one byte. 


‘text! 


specifies a programmer's comment. 


(registers[,registers]...) 
to ke 


e specifies the registers 
durped. 
e if aksent, implies that all reg- 


isters are to be dumped. 


Note on Printing Format: Unless the 
DATAM keyword operand is written, 


dumped registers (including floating- 
point registers) are printed in 
hexadecimal format. 


TCB| DCB|DEB 
specifies the system 
dumped, as follows: 


table to be 


TCB - the task control block for the 
active task. 

DCB - an open data 
whose address is the 
operand of the statement. 

DEB - the data extent block for an 
open data control block whose 
address is the third operand 
of the statement. 


control block 
third 


(symbol[l,symboil]...) 

e specifies the names of one or more 
TRACE statements that started traces 
which are to be stopped. 

e if absent, implies that ail 
traces are to be stopped. 


current 


ds DSECT=(symbol{,1i|,integer}) 
identifies a storage area as a dummy 
control section, or as part of a dummy 
control section. 


syinbol 

1. ais the name of the 
control section. 

2. Specifies the assumed loca- 
tion of the dummy control 
section, which must be 
addressable by means of a 
base register previously 
defined and ioaded by the 
problem program. 


dummy 


ijinteger 
1. specifies a number by which 
the length of tne storage 
area is multiplied on exe- 
cution of the statement. 
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2. specifies the maximum nun- 
ber of times the format of 
the aummy control section 
is to be repeated to define 
the format of printed 
information. 


d DATAM=[type] [L{length}] [S{scale}] 

e specifies type, length, and scale 
attributes. 

e determines either the length of a 
storage area when the third posi- 
tional operand is omitted, or the 
length of data (right justified) in 
a dumped register. 

*« determines either the printing for- 
mat for each field of a storage area 
when the DSECT operand is omitted, 
Or the printing format of data 
dumpea from a register. 


nm NAME=symbol 
® provides a symbol to be printed as 
the name of the first field of a 
dump. 
e suppresses the 
names as they are 
source program. 


printing of field 
Gefined in the 


ec COMMENT=‘text' 
annotates trace output 
programmer's comment. 


with a 


& SELECT={1]2|3(4|5]6]7]| 8} 

e classifies test information produced 
by the DUMP or TRACE statement; 
reclassifies this information if it 
has already been classifieqd ina 
TEST OPEN or TEST AT statement. 

e identifies the class py a number, 
which can be usea (in a job control 
statement) to select the class for 
printing by the TESTRAN editor. 
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TEST STATEMENTS 


TEST statements are of three types: 


Linkage statements: TEST OPEN 
TEST CLOSE 
Specification statements: TEST AT 


TEST DEFINE 


TEST ON 
TEST WHEN 


Decision-making statements: 


Each type is described separately. 


Linkage Statements 


The TEST OPEN and TEST CLOSE statements 
control linkage between the problem program 
and the TESTRAN interpreter. Their kasic 
functions are as follows: 


TEST OPEN 

e defines a 
having the 
ment itself. 

e opens the TESTRAN control section; 
loads the standard entry point reg- 
ister (15), and passes control to 
the problem program entry point 
(second operand). 

* specifies task options (third, 
fourth, MAXE, and MAXP operands). 

e chains the opening of other TESTRAN 
control sections (OPTEST operand). 

e classifies test information for sel- 
ective retrieval (SELECT operand). 


TESTRAN control section 
same name as the state- 


TEST CLOSE 


e closes the TESTRAN control section 
in which it is located. 

e closes any other TESTRAN' control 
sections that were opened at the 


same time by chained opening. 
® returns control to the problem pro- 
gram. 


A TEST OPEN statement defines a control 
section that includes all TESTRAN state- 
ments that precede the next TEST OPEN 
statement, if any, in the source program. 
It must be the first TESTRAN statement in 
the source program. 


When executed, the TEST OPEN statement 
"opens" the control section by reference to 
TEST specification statements. It esta- 
blishes a link to the TESTRAN interpreter 
at each test point specified in a TEST AT 
statement, and it creates counters’ and 
flags as specified in TEST DEFINE state- 
ments. 
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A TEST CLOSE statement closes a TESTRAN 
control section by nullifying the linkages, 
counters, and flags established when the 
control section was opened. When closed, a 
control section cannot ke entered by a 
branch from another TESTRAN control sec- 


tion, and its counters and flags cannot be 
used by statements in other control sec- 
tions. 


Operands: The operands of the TEST linkage 
statements are as follows: 


address 
e is placed in register 15. 
e receives control after TEST OPEN. 


e is required if TEST OPEN is execut- 
ed. 

e is ignored if TEST OPEN is not 
executed (i.e., if opening of the 


control section is chained by the 


execution of another TEST OPEN 
statement). 
task options 
e control testing under ae task and 
editing of the resulting test out- 


put. 

* can ke specified only in the first 
TEST OPEN statement executed under a 
task; are ignored when specified in 
other TEST OPEN statements. 

® are specified by five operands, one 
of which (the DDN operand) is some- 
times required in systems with MVT. 


symbol 
1. appears in the heading of 
each page printed by the 
TESTRAN editor. 
2. identifies test information 
produced under the task. 


LINK | LOAD 

1. specifies which system 
macro-instruction the TES- 
TRAN interpreter should use 
to load its nonresident 
modules. 

2. reduces (LINK) or increases 
(LOAD) both the storage 
requirements and the oper- 
ating speed of the inter- 
preter. 


DDN=SYSTEST|DDN=symbol 

1. points to the DD control 
Statement for the TESTRAN 
data set. 

2. is required (when testing a 
Gynamic parallel program in 
a system with MVT) to 
define a separate TESTRAN 
data set for each task 
under which testing is per- 
formed. 


MAXE=integer 
1. specifies the maximum num- 
ber of statements to be 
executed by the TESTRAN 
interpreter.1 
2. causes abnormal termination 
if the maximum is exceeded. 


MAXP=integer 
1. specifies the maximum num- 
ber of pages of test infor- 
mation to be produced.+ 
2. causes abnormal termination 
if the maximum is exceeded. 


OPTEST=(symbol[,symbol]l,...) 

-@® points to the TESTRAN control sec- 
tions defined by other TEST OPEN 
statements. 

e chains the opening of these control 
sections: causes all of them to be 
opened when the TEST OPEN statement 
is executed. 

® is ignored if the TEST OPEN 
ment is not executed. 


state- 


& SELECT={1]2[3|4|]5|6]|7|8} 

e classifies test information produced 
by control sections opened by the 
TEST OPEN statement. 

e identifies the class by a number, 
which can be used (in a job control 
statement) to select the 

_ printing by the TESTRAN editor. 

e is ignored if the TEST OPEN state- 
ment is not executed. 


Specification Statements 


The TEST AT and TEST DEFINE statements 
specify functions that are performed when 
the TESTRAN control section is opened: 


TEST AT 
e specifies one or more test points in 
the problem program (second 
operand). 
e classifies test information for sel- 
ective retrieval (SELECT operand). 


TEST DEFINE 
defines TESTRAN counters or flags. 


1This maximum must not exceed the installa- 
tion maximum established during system gen- 


eration. If it does, or if the operand is 
omitted, the installation maximum is 
assumed. 


class for: 


A TEST AT statement must be placed so 
that the next sequential TESTRAN statement 
is the first that should be executed at 
each specified test point. A TEST DEFINE 
statement can be placed anywhere in a 
TESTRAN control section. 


In an executed sequence of TESTRAN 
statements, a TEST AT statement returns 
control to the problem program. A TEST 


DEFINE statement performs no operation; the 
next sequential statement is executed. 


Operands: The operands of the TEST 
fication statements are as follows: 


speci- 


({*}address}[,address]...) 
¢ points to one or more test points in 

the problem program. 
e refers, if * is written, to the 
value of the location counter for 


the current problem program control ' 
section. 

e is subject to the following restric- 
tions: 


1. Each specified address must be 
that of an instruction in the 
problem program. 

2. The instruction must not be a 
privileged or SVC instruction, 
or an EX instruction that exe- 


cutes a privileged or SVC 
instruction. 
3. The instruction must not be 


modified by any instruction or 
executed by an EX instruction. 


$8 SELECT={1| 2] 3]4]|5|6|7] 8} . 

e classifies test information recorded 
at test points specified in the 
statement; reclassifies this infor- 
mation if it has already been clas- 
sified in a TEST OPEN statement. 

e identifies the class by a number 
which can be used (in a job control 
statement) to select the class for 
printing by the TESTRAN editor. 


COUNTER | FLAG 
determines whether counters 
are defined by the statement. 


or flags 


Note on Counters and Flags: A counter 
is a full-word, fixed-point value. A 


flag is a single binary digit. Both 
are set to zero when the control 
section is opened. Their values are 
lost when the control section is 
closed. 


(symbo1ll[,symbol]...) 
specifies a name for each counter or 
flag (the number of names determines 
the number of counters or flags that 
are defined). 
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Decision-Making Statements 


The TEST ON and TEST WHEN statements 
perform decision-making functions based on 
conditional branching to other TESTRAN 
statements. Their functions are as fol- 
lows: . 


TEST ON 
e increments a 
operand) by one. 


counter (COUNTER 


e tests the counter against three 
values (second, third, and fourth 
operands). 

e branches to a TESTRAN statement 


(fifth operand) if the value of the 
counter (1) is greater than or equal 
to the second operand, (2) is less 
than or equal to the third operand, 
and (3) is a multiple of the fourth 
operand. 


TEST WHEN (first form) 


e tests the value of a flag (second 
operand). 
e branches to a TESTRAN statement 


(third operand) if the value of the 
flag is one. 


TEST WHEN (second form) 
e specifies a logical relationship 
between two flags (second, third and 
'fourth operands). 
e branches to a TESTRAN 
(fifth operand) if the 
is correct. 


statement 
relationship 


TEST WHEN (third form) 

e specifies an arithmetic relationship 
between counters and/or variables 
(second, third, and fourth 
operands). 

e branches to a TESTRAN 
(fifth operand) if the 
is correct. 


statement 
relationship 


Operands: The operands of the TEST ON and 
TEST WHEN statements are as follows: 


ani address|register|integer 
e specifies a fixed-point value from 1 
to 231-1. 


address 
1. points to a 
fixed-point value 


full-word, 
in main 


storage; this value need 
not be on a fuli-word 
boundary. 

2. cannot be written as an 
integer. 
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register 
points to a fuli-word, fixed- 
point value in a general 
register. 

integer 
is a decimal value that is 
assembled as a full-word, 


fixed-point value. 


e if absent, implies the value 1 for 
the second or fourth operand, or the 
value 231-1 for the third operand. 


symbol 
e as the second or fourth operand, 
points to a flag defined by a TEST 
DEFINE statement. 
e as the third or fifth operand, 


points to a TESTRAN statement. 


COUNTER=s ymbol 
® points to a counter 
TEST DEFINE statement. 
e if absent, implies that the state- 
ment increments and testS an unnamed 


defined by a 


counter that is automatically 
defined for exclusive use by the 
statement. 
AND|OR 
specifies a logical relationship 


between the flags specified by the 
second and fourth operands. 


AND 
specifies that the 
both flags is one. 


value of 


OR 
specifies that the vaiue of one 
flag, or of both, is one. 


an address|register|literal 
specifies an arithmetic value. 


address 
points to a value in the prob- 
lem program or to a TESTRAN 
counter. 


register 
points toa 
ister. 


value in a reg- 


literal 
specifies a constant value that 
is assembled as part of the 
statement. 


Note on Data Format: If the DATAM 
Operand is omitted, the format (type 
and length) of both the second and 
fourth operands is implied as follows: 


e If the second operand is an 
address, the format is determined 
by the attributes of the first 
symbol used in the address. If the 
address contains no symbols, or 
only an external symbol, the format 
is determined by the fourth operand 
in the same manner as by the second 
operand. However, if the fourth 
operand is also an address, and 
contains no symbol other than an 
external symbol, the format is 
assumed to be hexadecimal with a 
length of one byte. 


°e If the second operand is ae ref- 
erence to a general register, the 
format is hexadecimal with a length 
of four bytes. If it is a ref- 
erence to a floating-point reg- 
ister, the format is floating-point 
with a length of eight bytes. 


e If the second operand is a literal, 
the format is specified or implied 
ty the literal notation. 


GT |GE|EQ|NE|LT| LE 


e specifies an arithmetic relationship 
between the values specified by the 
second and fourth operands. 

e has the following meaning: 


GT - greater than 

GE - greater than or equal to 
EQ - equal to 

NE - not equal to 

LT - less than 

LE - less than or equal to 


d DATAM=[typel] [L{length}] ([S{scale}] 


e specifies type, scale 
attributes. 

e defines the type and length of 
values specified by the second and 


fourth operands. 


length, and 


a a a a nn a a a a es as ae es as ae ae a a a a i a wn a a aes ae ee a es rr a a a an a ew ee se ee ee 


GO STATEMENTS 
The GO statements provide branching 
functions. Their kasic functions are as 
follows: 
GO TO 
branches unconditionally to a TESTRAN 
statement. 
GO IN 
calls a TESTRAN subroutine. 
GO OUT 
returns from a TESTRAN subroutine. 
GO BACK 


returns control to the problem pro- 
gram, Or passes control to a specified 
executable instruction. 
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Operands: The 
rents are as follows: 


operands of the GO state- 


symbol 


is the name of the TESTRAN statement 
that is branched to or that is the 
first statement of a TESTRAN' subrou- 


tine. 


Note on TESTRAN Subroutines: A maximum 


of three levels of TESTRAN subroutines 
can be maintained. The first level is 
lost if a fourth level is created. 


address 


e points to an executakle instruction 
to which control is passed. 

e if aksent, causes execution of the 
problem program instruction at the 
current test point. 
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SET STATEMENTS 


The SET statements assign values to 
counters, flags, and variables. Their 
functions are as follows: 


SET COUNTER 


assigns a value to a TESTRAN counter. 


SET FLAG 
assigns a value to a TESTRAN flag. 


SET VARIABLE 


assigns a value to a problem program 


variable (storage field or register). 
Operands: The second operand of each SET 


statement points to a 
variable; the third operand 
value that is assigned. 
as follows: 


counter, flag, or 
specifies the 
The operands are 


symbol 
e in a SET COUNTER statement, 
to a TESTRAN counter. 
e in a SET FLAG statement, points toa 
TESTRAN flag. 


points 


ank address | register|literal | 
specifies the new value of a counter 
or variable. 


address 
points to a value in the prob- 
lem program or to a TESTRAN 
counter. 


register 
points toa 
ister. 


value in ae ereg- 


literal 
specifies a constant value that 
is assembled as part of the 
statement. 
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=0|=1 
specifies the new value (zero or one) 
of a TESTRAN flag. 


address | register 
points to a variable to which a value 
is assigned. 


address 
points to a value in the prob- 
lem program. 
register 
points to a value ina reg- 
ister. 
Note on Data Format: If the DATAM 


is omitted, the length of the 
second and 


operand 
values specified by the 


third operands is determined as fol- 
lows: 

e If the second operand iS an 
address, the length is determined 
by the first symbol used in the 
address. If the address contains 


no symbols, or only an external 
symbol, the length is determined by 
the third operand in the same man- 
ner as by the second operand. How- 
ever, if the third operand is also 
an address and contains no symbol 
other than an external symbol, the 
length is assumed to be one byte. 
If the third operand is a literal, 
the length is specified or impliea 
by the literal notation. 

e If the second operand is a ref- 
erence to a general register, the 
implied length is four bytes. If 
it is a reference to a floating- 
point register, the implied length 
is eight bytes. 


d DATAM=[typel (L{length}] (S{scale}] 


e specifies type, length, and scale 
attributes. 

e defines the length of values 
specified by the second and third 


operands of a SET VARIABLE state- 


ment. 


within brack- 
They may be 
r‘s discretion. 


tical stroke | 
ore than one of 
ould ke coded 


is underlined, 
that is, the 

automatically 
rarmer's choice 
S$ coded. 


group related’ 


1 alternative 


cates that the 
of items can ke 
succession. 


ers to a_ foot- 
Of a statement. 


eee ae Format = TESTRAN Statements 


ce a a ep a a a a a rw ee cf a i i a a a a ee ee 
[Name |Operation|Operana | 
ca aCe : Coa eg ees SS Se ea are ee ter are eee re ee ee { 
| {Symbol ] | DUMP | {DATA] CHANGES}, address[,address][(,ds1{,d1i,n](,4] | 
| | nr nn en tr rrr rr nn er ner re eae 
| |COMMENT, 'text'[,4] 
| Sate ee SS es a a a a Ss Ss Se a ee ee ee ee a SS Se Se Se eS 
|MAP[,4] 
DI (SII ocr raterus eetarcabeteeet~tanacaererarnr mo { 
| |PANEL[, (registers[,registers]...)1{,d11,4] | 
Rt MI recs tapnrntseees cater cen rage’ eractanoer "a ame ae ge ee { 
| 


{ 
I 
| 
| 
| 
| 
| 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
i 


t 
{symboi] | TRACE 


} 
| TABLE, {TCB| {{DCB|DEB},address}}[,4] | 


--------- fon nnn nnn nnn} 
| CALL, address, address[,c]1[,4] | 


sympolt 


| 
| 
| 
| 
| 
| 
| 
+ 
| 
| 
| 
| 
| 
| 
| 
+ 
| 
| 
| 
| 
f 
or i a a {| 
pS 
| 
| 
| 
| 
| 
| 
+ 
| 
| 
| 
| 
mae 
|S 
| 
| 


Sa eee I a as oe ee at te OE eal cal a | 
ON, fart), Cart], lari], symool[, COUNTER=symbol] | 
Pee ca eS eR IN PEI eR le nO IIE On pa I a ET ENE oe oe { 
| WHEN, Syn.pol,symsoLl | 
i ee ee ee ean | 
| WHEN, symbol, {AND|OR},symbol,sympol | 
sa ORR he sgt a ne cI PE CaO pO aroha RR Oa Pn ER | 
|WHEN, an2,{GT|GE|LO|NE|LE|]LT},arz2,symbol[,4] | 
| 'symbol1] |Go fogtsomen ee ris ee 
| }---------~-------~-~~-~------~----- === === == == +2 === === | 
| | OUT | 
| p---------~~------ --- =~ - $= =~ $$ 2 nnn nnn nnn nn nnn { 
| | BACK(,address] | 
}--------4--------- }-------------------------~------------------------------------------ 
| {symbol] {| COUNTER, symboi,anrl : ; 
| ~---------~---------------~-~------ == ---- +--+ === === === ---~---~---- { 
| | FLAG, symbol, {sympol|=0]|=1} | 
re ee ee { 
t 


2A symbol is ee in the nane field of a TEST OPEN statement; it is opticnai in| 
other TEST statements. | 
2This operand can be written only as a nonindexed implied address. | 


Table 3. Definitions of Abbreviations Used in Table 2 


aL eeeeyey Sellen eee pol Ree aaan ee Se ae ee ee ee ee eee ee ee eee eee 
iAppreviaviont Definition 1 
Anh |address|register|integer 
ank jaddress|register|iliteral : | 
c | COMMENT=' text!" | 
d | DATAM=[type] [Lf{length}] [S{scale}] | 
ds | DSECT=(symbol{,1|,integer}) | 
n | NAME=sympol | 
5 | SELECT={1]2[3]4]5]6{7| 8} | 
task opécons | [symbol] {,LINK| « LOAD} {, DPN= =SYSTEST| , DDN= re: | 


| a C, /MAXE=integer) [, MAS ESapeedert| 


Table 4. Definitions of Variables Used in Tables 2 and 3 


So ne eee SSS SS St a a or ee ae re ee ee ee eve 
[variable | Definition | 
bi a i a eee I eae aaa ea oe aaa a | 
Perea jAn indexed or noninaezed implied or explicit address?+ | 
jinteger JA decimal self-defining term | 
jlength JAn unsigned decimal integer (see Table 5) | 
| literal jA constant preceded by an equal sign (=) | 
|xegister JA pointer to a general or floating-point register? | 
|registers JA pointer to one or a series of general or floating-point registers? | 
|scale j|A signed or unsigned decimal integer (see Table 5) | 
|symbol JA string of letters and digits that begins with a letter and is not | 
| | longer than eight characters | 
{text {A character constant? | 
|type JA standard data type code (see Takle 5) | 
}------------ bo en - - en- 4 
1The format of an address is given Ly the fcllowing takle: | 
| 

indexed Nonindexed | 

Implied address s(x) s | 

Explicit address d(x, b) d(0,b) | 

| 


s is an absolute or relocatable expression; d, x, and Fk are absolute | 
expressions. s is a numeric or symbolic storage address; x is an index| 

register number; d is a displacement from a base address; b is a_ kase| 

address register number. : | 

| 

An implied address is assembled in base-displacement form only if a DSECT operand| 
‘appears in the same statement. Normally, it is evaluated by an A-type address| 
constant. -If it is indexed, its effective value is that of the constant plus the| 


contents of the index register at the time the statement is executed. 


2The format of the pointer is given ky the following table: 


Single Series of 
Register Registers 
General register G'reg' G'reg,,regn' 


Floating-point register F'reg' F*reg,,regn'" 

reg, reg,;, and regy are each a symbol or decimal integer whose value is a 
valid register number. reg, and regn are the first and last registers of 
a series. regyn can have either a higher or a lower value than req). 


3The format of the character constant is that of the constant subfield of a DC] 

statement that defines a character constant. As shown in Tables 2 and 3, the constant| 
is enclosed by apostrophes. The constant can include any valid. EBCDIC character, aaah 
must include a pair of apostrophes ox ampersands to represent a single apostrophe (")| 
or ampersand (6&). The maximum length is 120 characters, counting each pair of| 
apostrophes or ampersands as a single character. | 


Table 5. Definition of Type, Length, and Scale 


[ese r=sSeresSs ser Pon eer eee = {SSS SS Sa ees 1 
| Type | | | 
| | Length in kbytes? | Scale? | 
[----7-------------- $~---------=---=- q77-------- { | 
| Code| Meaning | Specified | Implied | | 
[----}-------------- ---------------- fran nn nanan panna nnn nn nnn nn nn nnn nnn nnn nnn { 
| C |character [ito 256 LL | (nct applicable) | 
| X |hexadecimal j1 to 256 | a { (not applicable) | 
| B [binary j1 to 256 | 1 | (nct applicable) | 
| H |fixed-point' |1 to 8° | 2 |-187 to +346 | 
| F |f£ixed-point. |1 to 8 | 4 [-187 to +346 | 
| E. |floating-point|1 to 8 | 4 | (nct applicable) | 
| D |floating-point|1 to 8 | 8 | (not applicakle) | 
| P |packed decimal|1 to 16 | 1 | (not applicable) | 
| Z |zoned decimal |1 to 16 1 | (not applicable) | 
} I [instruction eas bei iceb ie) | tvestahie eee applicable) .. | 
|----1--------------1---- === === == == hn gb nnn nnn nnn nnn nnn { 

| 


1The implied ieacen: is used if the eee but Rot the length, is specified. 
2The implied scale is zero if no scale is specified. If a positive scale is intended, | 
the sign (+) can be omitted. | 
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This 


appendix 


APPENDIX B: 


to in Section 3 of this publication. 


PROCEDURE ASMEC 


ee ie ee cae ane te te ee ne A a ce Se eh <a cy ae ee me ne he cee ee cee care ce se me ate tn ee ae ae ee ae ae a ee es cee ee te 


é 
| //ASM 

| //SYSLIB 
| //SYSUT1 
| //SYSUT2 
| //SYSUT3 
| // 

| 

| 

L 


//SYSPRINT DD SYSOUT=A 
//SYSPUNCH DD UNIT=SYSCP 
PROCEDURE ASMFC 
pee ei See ee aa ee ee ee ae ee 
| //ASM EXEC PGM=IEUASM, REGION=50K 
| //SYSLIB DD DSNAME=SYS1.MACLIB, DISP=SHR 
| //SYSUTL DD UNIT=SYSSQ,SPACE=(1700, (400,50)) 
| “/SYSUT2 DD UNIT=SYSSQ,SPACE=(1700, (400,50)) 
| //SYSUT3 DD UNIT=(SYSSQ,SEP=(SYSUT2,SYSUT1,SYSLIB)), 
| // SPACE= (1700, (400,50)) 
| //SYSPRINT DD SYSOUT=A 
| //SYSPUNCH DD SYSOUT=B 
beac ee oS ee So a ee eee ae ee ea ee ee ee See eas See ae eee ea ee ae 


//UKED 


/7/SYSPRINT DD 


//SYSLIN 


// 
//SYSUT1 
// 


| 
|: 7/SYSLMOD DD 
| 
| 
| 


EXEC PGM=IETASM 

DD DSNAME=SYS1.MACLIB, DISP=OLD 

DD UNIT=SYSSQ,SPACE=(400, (400,50) ) 

DD UNIT=SYSSQ,SPACE=(400, (400,50) ) 

DD UNIT=(SYSSQ,SEP=(SYSUT2,SYSUT1,SYSLIB)), 
SPACE= (400, (400,50) ) 


EXEC PGM=IEWL, PARM='XREF, LIST, LET, NCAL' , REGICN=96K 
SYSOUT=A 

DD DDNAME=SYSIN 
DSNAME=&GOSET (GO) , SPACE=(1024, (50,20,1)), 
UNIT=SYSDA , DISP= (MOD, PASS) 

DD UNIT=(SYSDA,SEP=(SYSLMOD,SYSLIN)), 

SPACE= (1024, (200,20) ) 
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00020000 
00040000 
00060000 
00080000 
C00100000 
00120000 
00140000 
00160000 


00020000 
00040000 
00060000 
00080000 
C00100000 
00120000 
00140000 
00160000 


00020000 
00040000 
00060000 
C00080000 
00100000 


C00120000 . 


00140000 


Statements 


IBM-~SUPPLIED CATALOGEIL PROCEDURES 


defines cataloged procedures that are supplied by IBM and are referred 
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PROCEDURE TASME 


75 


r 
| 
| 
| 
| 
| 
| 
| 
| 
! 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 


//ASM 
//SYSLIB 
//SYSUT1 
//SYSUT2 
//SYSUT3 
// 


//SYSPRINT 
//SYSPUNCH 


4/ 

//UKED 
//SYSPRINT 
//SYSLIN 
// 
//7SYSLMOD 
// 
//SYSUT1 
// 


EXEC PGM=ASMBLR, PARM=TEST, REGION=50K 


DD 
DD 
DD 
DD 


DD 
DD 


EXEC PGM=IEWL, PARM= (XREF,LIST,LET,NCAL,TEST) ,REGION=96K 


DD 
DD 
DD 
DD 


0 
oO 


DSNAME=SYS1.MACLIB,DISP=SHR 

UNIT= (SYSSQ,SEP= (SYSLIB) ) , SPACE= (1700, (400, 50) ) 
UNIT= (SYSSQ, SEP= (SYSUT1) ) , SPACE= (1700, (400,50) ) 
UNIT= (SYSSQ,SEP= (SYSLIB,SYSUT2)) , 

SPACE= (1700, (400,50) ) 

SYSOUT=A 

DSNAME=&LOADSET, UNIT=SYSDA, 

SPACE= (80, (200,50) ) , DISP= (MOD, PASS) 


SYSOUT=A 

DSNAME=6 LOADSET , DIS P= (OLD, DELETE) 
DDNAME=SYSIN 
DSNAME=&GOSET (GO) , SPACE= (1024, (50,20, 1)), 
UNIT=SYSDA, DISP= (MOD, PASS) 

UNI T= (SYSDA, SEP= (SYSLMOD, SYSLIN) ) , 

SPACE= (1024, (200,20) ) 


Appendix B: 


00020000 
00040000 
00060000 
00080000 
C00100000 
00120000 
00140000 
C00160000 
00180000 
00200000 
00220000 
00240000 
00260000 
C00280000 
00300000 
C00320000 
00340000 


IBM-Supplied Cataloged Procedures 


| 
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PROCEDURE TASMEG 


Qa ay eS ee ae a OP pk ET LY Oe eA SO ee Se pe. we eel we gig = hag Gis bs a ee Sa a Meet a AA ea Te ee eee 1 
| //ASM EXEC PGM=ASMBLR, PARM=TEST, REGION=50K 00020000 | 
| //SYSLIB DD DSNAME=SYS1.MACLIB, DISP=SHR 00040000 | 
| //SYSUT1 DD UNIT=(SYSSQ,SEP=(SYSLIB) ) , SPACE= (1700, (400,50) ) 00060000 
| //SYSUT2 DD UNIT=(SYSSQ,SEP= (SYSUT1) ).,SPACE= (1700, (400, 50) ) 00080000 
| //SYSUT3 DD UNIT=(SYSSQ,SEP=(SYSLIB,SYSUT2)), - €00100000 
| // SPACE= (1700, (400,50) ) 00120000 
| //SYSPRINT DD SYSOUT=A 00140000 | 
| //SYSPUNCH DD DSNAME=&LOADSET, UNIT=SYSDA, C00160000 
| 47 SPACE= (80, (200,50) ) , DISP= (MOD, PASS) 00180000 
| //LKED EXEC PGM=IEWL, PARM= (XREF,LIST,LET,NCAL,TEST) ,REGION=96K 00200000 | 
| //SYSPRINT DD SYSOUT=A 00220000 | 
| //SYSLIN DD DSNAME=§LOADSET, DISP= (OLD, DELETE) 00240000 | 
{ // DD DDNAME=SYSIN 00260000 | 
| //SYSLMOD DD DSNAME=&GOSET (GO) ,SPACE= (1024, (50,20,1)), C00280000 | 
| // UNIT=SYSDA, DISP= (MOD, PASS) 00300000 
| //SYSUT1 DD UNIT=(SYSDA,SEP= (SYSLMOD,SYSLIN)), C00320000 | 
1 // SPACE= (1024, (200, 20) ) 00340000 | 
| 7/GO EXEC PGM=*.LKED.SYSLMOD 00360000 
ai ann a a a a i cs a a a a a a i re ee ae ete a 


PROCEDURE TASMEGED 


Se ee ee er ee 
| 77ASM EXEC PGM=ASMBLR, PARM=TEST,REGION=50K 00020000 | 
| 7/SYSLIB DD DSNAME=SYS1.MACLIB,DISP=SHR 00040000 | 
| //SYSUT1 DD UNIT=(SYSSQ,SEP= (SYSLIB) ) ,SPACE= (1700, (400,50) ) 00060000 
| //SYSUT2 DD UNIT=(SYSSQ,SEP=(SYSUT1)) ,SPACE= (1700, (400,50) ) 00080000 
{| //SYSUT3 DD UNIT=(SYSSQ,SEP= (SYSLIB, SYSUT2)), c00100000 | 
| 77 SPACE= (1700, (400, 50) ) 00120000 | 
| “7/SYSPRINT DD SYSOUT=A 00140000 | 
| 77SYSPUNCH DD DSNAME=&LOADSET,UNIT=SYSDA, C00160000 | 
| 77 SPACE= (80, (200,50) ) ,DISP= (MOD, PASS) 00180000 | 
| 7/LKED EXEC PGM=IEWL, PARM= (XREF,LIST,LET,NCAL,TEST) ,REGION=96K 00200000 | 
| “/SYSPRINT DD SYSOUT=A 00220000 | 
| 7/SYSLIN DD DSNAME=&LOADSET,DISP= (OLD, DELETE) 00240000 | 
| // DD DDNAME=SYSIN 00260000 | 
| //SYSLMOD DD DSNAME=&GOSET (GO) ,SPACE= (1024, (50,20,1)), c00280000 
| 77 UNILT=SYSDA, DIS P= (MOD, PASS) 00300000 | 
| “/SYSUT1 DD UNIT=(SYSDA,SEP=(SYSLMOD,SYSLIN)) , C00320000 | 
| 77 SPACE= (1024, (200,20) ) 00340000 | 
| 7/7GO EXEC PGM=*.LKED.SYSLMOD 00360000 | 
| //SYSTEST DD DSNAME=&TESTSET, SPACE= (300, (200,50)), c00380000 | 
| 77 UNIT=SYSSQ, DIS P= (NEW, PASS) 00400000 | 
| “/7EDIT EXEC PGM=LEGTTEDT, REGION=50K 00420000 | 
| 7/SYSUT1 DD UNIT=SYSDA,SPACE= (500 (300, 100) ) 00440000 | 
| “/SYSTEST DD DSNAME=§ETESTSET, UNIT=SYSSQ,SEP=SYSUT1, c00460000 | 
| // DISP= (OLD, DELETE) 00480000 | 
| “/SYSPRINT DD SYSOUT=A 00500000 | 
| —-------—-----_---—------_--------------------_-_---------__----_-----__ +] 
| Note: In the job step EDIT, the statement SYSUT1 defines a work data set for the | 
| TESTRAN editor. This data set must be on a direct-access device. Its primary space | 
| allocation must be at least two tracks. | 
a Rt ee Ne Sle ORD ren Fe Tp DO NE pe SC | NE PS CE eS 


PROCEDURE TTED 


{| /“/7EDIT EXEC PGM=IEGTTEDT, REGION=50K 00020000 | 
| //SYSUT1 DD UNIT=SYSDA,SPACE= (500, (300, 100) ) 00040000 | 
|] 7/SYSPRINT DD SYSOUT=A 00060000 | 
| -~-- == 8 
| Note: See note to the procedure TASMEGED. | 
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APPENDIX C: TESTRAN MESSAGES 


This appendix reproduces the following sections from the publication IBM System/360 
Operating System: Messages and Codes: 


TESTRAN Editor Messages 
TESTRAN Interpreter Messages 
TESTRAN Macro-Expansion Messages 


Table 6 describes the messages in these sections. 


On ae aaa: Taos ee ep a eye a re are eee I OTe oe Ra a a 1 
| MESSAGE | WHERE | | | 
| |PRINTED  |MESSAGE FORMAT | COMMENTS | 
pom ne {-———-----— a fn nn en en cen { 
| TESTRAN | TESTRAN j*** TIEGEnn text |Messages indicate errors | 
| Editor {Listing | {found during the editing | 
|Messages | (TESTRAN |IEG = TESTRAN message code Jo£f test output. | 
| | editor jEnn = Message serial number | | 
| |SYSPRINT | indicating the | | 
| |data set) | TESTRAN editor | | 
| | jtext = Message text | | 
[-——--~——-— toa fon fn { 
| TESTRAN | TESTRAN {*** IEGInn text |Messages indicate errors | 
|Interpreter|Listing | jfound by the TESTRAN inter- | 
|Messages | (TESTRAN |IEG = TESTRAN message code [preter during execution of | 
| | editor Jinn = Message serial number {the program being tested. | 
| |SYSPRINT | indicating the | | 
| | data set) | TESTRAN interpreter | | 
| | jtext = Message text | | 
~----~----—}-----—---- $-----~~---------=----—-------------}--------------------------- 
| TESTRAN jAssembly |ss,*** IEGMnn text |Messages indicate errors in | 
|Macro- | Listing | [the position and syntax of | 
[Expansion {| (Assembler|ss = Severity code, which is |TESTRAN statements. The | 
| Messages |SYSPRINT | one of the following: jassembler finds these errors| 
Jdata set) | * Informational message; jwhen it expands TESTRAN | 
| | no effect on execution | statements (macro-instruc- _ | 
| | 4 Warning message; success-|tions) into sequences of | 
| | ful execution is probable|assembler language state- | 
| | 8 Error; execution may fail|ments. If errors ina | 
| | 12 Serious error; successful|source statement cause | 
| | execution is improbable |errors in its expansion, the| 
| J|IEG = TESTRAN message code jassembler may issue addi- | 
| |Mnn = Message serial number [tional messages when it | 
| | indicating macro-expansion |assembles the statements in | 
| {text = Message text |the expansion. The addi- | 
| | {tional messages do not have | 
| | |TESTRAN message codes and | 
| | jare not included in this | 
| | | appendix. | 
pM eS aaa Mt hae A 


[ree ce me ce SS ee SS ee SS ee eS eS 
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TESTRAN EDITOR MESSAGES 


IEGEO2 


IEGEO3 


ITEGEO4 


IEGEOS5 
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UNKNOWN MACRO 


Explanation: During TESTRAN edit- 
ing, an input record could not be 
related to a TESTRAN' statement 
(macro-instruction) associated with 
the task that produced the data 
set. 


System Action: The count of inva- 
lid records was incremented, and 
the record was ignored. 


EXCESSIVE CHANGE DUMPS 


Explanation: During TESTRAN edit- 
ing, the output from an excessive 
number of DUMP CHANGES statements 
was selected for editing by the 
TESTRAN editor. 


System Action: Only the output 
from the allowable number of DUMP 
CHANGES statements was edited. 


User Response: 
from subsequent DUMP CHANGES state- 


ments, repeat the job step without 
selecting the output from the DUMP 
CHANGES statements already edited. 


INVALID RECORD--IGNORED 


Explanation: During TESTRAN edit- 
ing, an invalid or unreadable input 
record was encountered. 


System Action: The count of inva- 
lid records waS incremented, and 
the record was ignored. 


EXCESSIVE 
DISCONTINUED 


INVALID RECORDS--EDIT 


Explanation: 
ing, the number of invalid or unre- 


adable records in the data _ set 
exceeded the allowable limit. 


The job step was 


System Action: 
terminated. 


User Response: Determine whether 
the correct data set was used as 
input. If it was, recreate the 
data set by executing the problem 
program again. 


To edit the output 


During TESTRAN edit- 


IEGE06 


IEGEO7 


IEGEO8 


IEGEO9 


ITEGE10 


EXCESSIVE OUTPUT 


Explanation: During TESTRAN edit- 
ing, the amount of edited output 
exceeded the limit specified in the 
PARM parameter of the. EXEC state- 
ment for the job step being tested. 


System Action: The job step was 
terminated. 

User Response: Execute the job 
step again, specifying either a 


higher page limit or fewer output 
class identification numbers. 


END OF TESTRAN EDIT--xxx STATEMENTS 
PROCESSED 


TESTRAN editing was 
completed. 
In the message text, xxx is the 
number of TESTRAN statements 
executed by the TESTRAN 
interpreter. 


INVALID OVERLAY RECORD 


Explanation: During TESTRAN edit- 
ing, an input record specified a 
change in an unknown overlay 
segment. 

record 


The was 


System Action: 
ignored. 


INVALID RELOCATION 
DISCONTINUED 


RECORD--EDIT 


Explanation: During TESTRAN' edit- 
ing, an input record contained con- 
trol section relocation information 
that did not correspond to the 
control section definitions of the 
program that was being tested. 


The job step was 


System Action: 
terminated. 


User Response: Determine whether 
the correct data set was used as 
input. If it was not, recreate the 
data set by executing the problem 
program again. 


EXCESSIVE 
ENTRY xxx 


SECTION DEFINITIONS-- 


Explanation: During TESTRAN edit- 
ing, the number of definitions of 
control, dummy, and blank common 
sections exceeded the limit allowed 
in the tested program. 


IEGE11 


IEGE12 - 


IEGE13 


In the message text, xxx is the 
entry name of the excess section. 


System Action: Dumps and traces of 
the excess sections were printed in 
4—-byte hexadecimal format, except 
where this format was overridden by 
DATAM operands. 


Reduce control sec- 


User Response: 


tions, dummy sections, and blank 
common sections to the allowable 
number. Count each TESTRAN control 
section once for each time it is 
opened. 

EXCESSIVE ‘TEST AT'S 


Explanation: During TESTRAN edit- 
ing, the number of supervisor call 
(SVC) instructions inserted by TEST 
AT statements exceeded the limit. 


System Action: Data resulting froin 
the excess supervisor call instruc- 
tions was ignored. 


User Response: Reduce problem pro- 
gram addresses specified by TEST AT 


statements to the allowable number. 
Count each address once for each 
opening of the TESTRAN control sec- 
tion in which the address is 
specified. 

EXCESSIVE ‘TEST OPEN'S 

Explanation: During TESTRAN edit- 


ing, the opening of TESTRAN control 
sections by TEST OPEN statements 
exceeded the limit. 


System Action: Data resulting from 
the excess control section openings 
was ignored. 


User Response: Reduce TESTRAN con- 
trol section openings to the allow- 
able number. 


UNABLE TO OPEN 


Explanation: During TESTRAN' edit- 
ing, a required data set could not 
be opened because no DD statement 
was supplied for the data set. 


System Action: The job step was 
terminated. 

User Response: Supply the missing 
DD statement and execute the job 


step again. 


IEGE14 


IEGE15 


TESTRAN 


IEGI00 


IO ERROR 


Explanation: During TESTRAN edit- 
ing, an uncorrectable input/output 
error occurred. 
System Action: The job step was 


terminated. 


User Response: If the input/output 
error persists, have the computing 
system checked.” 


EXCESSIVE SEQUENCE BREAKS 


Explanation: During TESTRAN edit- 
ing, the assembler symbol tables 
proved unusable. There were too 
many breaks in the sequences of 
source statements defining named, 
unnamed, dummy, and biank common 
control sections. 


System Action: job step was 


The 
terminated. 


User Response: Restructure the 


source program to minimize the 
number of interruptions and con- 
tinuations in the definition of 
each control section. Alternative- 
ly, assemble the program without 
symbol tables (i-e., Without the 
TEST option), and use the DATAM 


operand to specify printing format. 


INTERPRETER MESSAGES 
INVALID ADDRESS--IGNORED 


Explanation: During execution of 
the TESTRAN interpreter, a TESTRAN 
statement referred to an address 
higher than the highest address in 
main storage. 


The statement was 


System Action: 
ignored. 


If the job step is 
again, make sure 
that all address operands were spe- 
cified correctly and were not modi- 
fied. Also, check the contents of 
any registers referred to in the 
statement. Correct the error. 


User Response: 
to be executed 
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TEGIO1 


IEGIO2 


TEGIO3 


78 


INVALID ‘GO TO" AT xxx 
Explanation: During execution of 


the TESTRAN interpreter, a GO TO or 
GO IN statement did not specify in 
its second operand the address of a 
TESTRAN statement in an open con- 
trol section. 

the 


In the message text, xxx is 


address in hexadecimal of the GO TO: 


or GO IN statement. 


The statement was 
sta- 


System Action: 
ignored. The next sequential 


tement was executed. 


User Response: If the job step is 
to be executed again, make sure 


that the second operand specified 
the address (symbolic name) of a 
TESTRAN statement and was not inco- 
rrectly modified. Also make sure 
that the control section containing 
the address will be open when the 


GO TO or GO IN statement is 
executed. 

INACTIVE ‘GO TO" AT xxx 
Explanation: During execution of 


the TESTRAN interpreter, a GO TO or 
GO IN statement in an overlay pro- 


gram specified as its second 
operand the address of a TESTRAN 
statement. This statement was ina 


control section that was not 


rently in main storage. 


cur- 


In the message text, xxx is the 
address in hexadecimal of the GO TO 
or GO IN statement. 


System Action: The GO TO or GO IN 
statement was ignored. The next 
sequential statement was executed. 


User Response: If the job step is 
to be executed again, make sure 


that the control section containing 
the specified address will be in 
main storage when the GO TO or GO 
IN statement is executed. 


\ 


INVALID 'GO OUT‘ AT xxx 
Explanation: During execution of 


the TESTRAN interpreter, a GO OUT 
statement was to be executed, but 
the associated GO IN statement had 
not saved a return address. 


IEGIO4 


IEGIO5 


In the message text, xxx is the 
address in hexadecimal of the GO 
OUT statement. 


The GO OUT state- 
GO BACK 
second 


System Action: 
ment was treated as a 


statement in which the 
operand was omitted. 


User Response: If the job step is 
to be executed again, determine why 
the return address was missing, 
making sure that no attempt was 
made to save more than three return 
addresses. 


NULL ‘TEST OPEN' ENTRY POINT--ABEND 
Explanation: During execution of 
the TESTRAN interpreter, a TEST 


OPEN statement did not specify as 
its second operand an entry point 
address in the problem program to 
which control could be returned. 
System Action: The task was ter- 
Mminated abnormally. 


Specify the entry 
point address in the TEST OPEN 
statement, making sure that the 
statement was not incorrectly modi- 
fied. Alternatively, avoid execu- 
tion of this statement by listing 
it in the OPTEST operand of another 
TEST OPEN statement. 


User Response: 


INVALID ‘TEST AT'-~-IGNORED 
Explanation: During execution of 
the TESTRAN interpreter, the second 
operand (address sublist) of a TEST 
AT statement specified an address 
that was outside the boundaries of 
the main storage assigned to the 
current task. 


System Action: A supervisor call 
(SVC) instruction was not inserted 
at the erroneous address. Supervi- 
sor call instructions were inserted 
at valid addresses specified in the 
same sublist. 


If the job step is 
to be executed again, make sure 
that the address was specified 
correctly and was not incorrectly 
modified. Correct the error. 


User Response: 


IEGIO6 EXCESSIVE OUTPUT REQUESTED 


During execution of 
interpreter, the MAXP 
TEST OPEN statement 
limit higher than the 

limit on TESTRAN 


Explanation: 
the TESTRAN 


operand of a 
specified a 
installation's 
output. 


System Action: The installation's 
limit was used instead of the limit 
specified by the statement. 


User Response: If the job step is 
to be executed again, eliminate the 
MAXP operand, or specify a limit 
less than or equal to the installa- 
tion's limit. 


IEGIO7 


EXCESSIVE PROCESSING REQUESTED 


Explanation: During execution of 


the TESTRAN interpreter, the MAXE 
operand of a TEST OPEN statement 
specified a limit higher than the 
installation's limit on processing 


by the TESTRAN interpreter. 


System Action: The installation's 
limit was used instead of the limit 
specified by the statement. 


User Response: If the job step is 
to be executed again, eliminate the 
MAXE operand, or specify a limit 
less than or equal to the installa- 
tion's limit. 
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IEGIO8 


IEGIO9 


IEGI10 


LIMIT OF ONE 'TEST OPEN" IN OVERLAY 


Explanation: During execution of 
the TESTRAN interpreter, a second 
TEST OPEN statement was executed in 
an overlay program. 


System Action: No control sections 
were opened on execution of the 
second TEST OPEN statement. Con- 
trol was returned to the problem 
program at the address specified by 
the second operand. 


User Response: If the job step is 
to be executed again, remove’ the 
second TEST OPEN statement from the 
overlay program. The one TEST OPEN 
Statement allowed must be in the 
root segment. Its OPTEST operand 
should specify the names of other 
TEST OPEN statement 5 for which 
control sections are toc be opened. 


"AT' LOCATION CONTAINS INVALID 
TESTRAN SVC 


Explanation: During execution of 
the TESTRAN interpreter, a supervi- 
sor call (SVC) instruction was not 
inserted in the program being test- 
ed when the TESTRAN control section 


was Opened by a TEST OPEN state- 
ment. The address in the program 
at which the Supervisor call 
instruction should have been 
inserted was specified in a TEST AT 
statement. The supervisor call 


instruction would have called the 
TESTRAN interpreter. 


System Action: The address in the 
TEST AT statement was ignored and a 
supervisor call instruction was not 
inserted. 


If the job step is 
to be executed again, make sure 
that the address specified in the 
TEST AT statement (1) was correct, 
(2) was not incorrectly modified, 
and (3) was the address of an 
executable problem program instruc- 
tion. 


User Response: 


DUMP TRUNCATED AT END OF STORAGE 


Explanation: During execution of 
the TESTRAN interpreter, a DUMP 
DATA or DUMP CHANGES statement 


specified an ending address that 
was higher than the highest address 
in main storage. 


IEGI11 


IEGI12 


System Action: Only the _ storage 
from the starting address to the 


end of storage was dumped. 


User Response: If the job step is 
to be executed again, make sure 
that the third positional operand 


specifies an address within storage 


and that it was not incorrectly 
modified. 

"TEST OPEN' LIMIT REACHED 
Explanation: During execution of 
the TESTRAN interpreter, TESTRAN 


control sections had been opened 
255 times and another request to 
open a TESTRAN control section was 
found in the same task. TESTRAN 
control sections can be opened only 
255 times during execution of one 
task. 


System Action: No additional con- 
trol sections were opened. Control 
was returned to the problem program 
address specified by the TEST OPEN 
Statement that was executed most 


recently. 

User Response: If the job step is 
to be executed again, count the 
number of times TESTRAN control 
sections are opened. A control 
section is counted once for each 
time it should be opened according 


to the logic of the program. 
Change the program to reduce the 
total openings if they exceed 255. 
If the total openings are fewer 
than 256, check for an uncontrolled 
loop that might cause repeated 
opening and closing of one or more 
control sections. 


DUMP TRUNCATED AT TASK BOUNDARY 


Explanation: During execution of 


the TESTRAN interpreter, a DUMP 
DATA or DUMP CHANGES) statement 
specified an ending address’ that 
was outside the boundaries of the 


main storage assigned to the task. 


System Action: Only the storage 
from the starting address to the 


task boundary was dumped. 


User Response: If the job step is 


to be executed again, make sure 
that the second and third posi- 
tional operands of the statement 
were specified correctly and were 
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IEGI13 


IEGI15 


. TEGI16 


IEGI17 
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not incorrectly modified. If the 
program is scatter loaded, both 
operands should specify addresses 


in the same control section. 


INVALID "SET VARIABLES ‘TO" ADDRESS 


Explanation: During execution of 
the TESTRAN interpreter, a SET 
VARIABLE statement specified a 
variable at an address that was 
outside the main storage assigned 


to the task. 


System Action: The SET VARIABLE 


statement was ignored. 


If the job step is 
to be executed again, make sure 
that the address of the variable 
was specified correctly and was not 
incorrectly modified. Also check 
the contents of any registers 
referred to in the statement. 


User Response: 


UNDEFINED COUNTER 


During execution of 
the TESTRAN interpreter, a SET 
COUNTER or TEST ON statement 
referred to a TESTRAN counter that 
was not in an open TESTRAN control 
section. 


Explanation: 


The statement was 


System Action: 
ignored. 


User Response: If the job step is 
to be executed again, define the 


counter with a TEST DEFINE state- 
ment in a control section that will 
be open when the counter is 
referred to. 


TESTRAN CSECT ALTERED 


Explanation: During execution of 
the TESTRAN interpreter, a control 
section containing TESTRAN state- 
ments was modified. 


System Action: The task was termi- 
nated abnormally. 


User Response: Find the error that 
caused the TESTRAN control section 
to be modified, correct it, and 
execute the job step again. 


MAXIMUM PAGES EXCEEDED 


Explanation: During execution of 
the TESTRAN interpreter, the limit 
on TESTRAN output was exceeded. 


IEGI18 


IEGI19 


IEGI20 


System Action: The task was termi- 
nated abnormally. 


User Response: If excessive output 


was produced, check for errors in 
the statements that cause output 
and in the sequence in which they 
were executed. If the output was 
not excesSive, specify a higher 


limit in the MAXP operand of the 
first TEST OPEN statement executed 
in the task. Then execute the job 
step again. 


MAXIMUM STATEMENTS EXCEEDED 


Explanation: During execution of 
the TESTRAN interpreter, the number 
of TESTRAN statements that can be 
processed during a single task 
exceeded the limit. 


System Action: The task was termi- 
nated abnormally. 


User Response: Check the test out- 
put for logical errors that would 
cause excessive processing. If no 
errors are found, specify a higher 
limit in the MAXE operand of the 
first TEST OPEN statement executed 
in the task. Then execute the job 
step again. 


INVALID TESTRAN SVC--IGNORED 


Explanation: Control was given to 
the TESTRAN interpreter by a super- 
visor call (SVC) instruction. The 
supervisor call instruction was not 
inserted by the TESTRAN interpreter 
in the current task. 


System Action: No testing was per- 
formed. Control was returned to 


the location following the invalid 
supervisor call instruction. 


User Response: If the job step is 
to be executed again, remove the 
invalid instruction or correct it. 


INACTIVE TESTRAN SVC~-IGNORED 


Explanation: Control was given to 
the TESTRAN interpreter by a super- 
visor call (SVC) instruction that 
had been inserted during opening of 
a TESTRAN control section in anoth- 
er overlay segment. The segment 
containing the control section had 
been overlaid. 


IEGI21 


ITEGI22 


System Action: No testing was per- 
formed. The displaced problem pro- 


gram instruction was executed, and 
control was returned to the next 
sequential instruction. 


User Response: If the job step is 
to be executed again, check all 
TEST AT statements to ensure that 
they specify problem program 
addresses in the same overlay seg- 
ment. Correct any erroneous 
addresses. 

INVALID "TEST ON' BRANCH ADDRESS 


Explanation: During execution of 
the TESTRAN interpreter, a TEST ON 
statement should have branched to 
another TESTRAN statement. The 
other statement was not in an open 
control section. 


System Action: No branch occurred. 
The next sequential statement was 
executed. 


User Response: If the job step is 
to be executed again, check the 
branch address which is specified 


by the fifth operand of the TEST ON 
Statement. Ensure that the control 
section containing the address will 
be open when the TEST ON statement 
is executed. 


INACTIVE "TEST ON' BRANCH. ADDRESS 


Explanation: During execution of 
the TESTRAN interpreter, a TEST ON 
Statement should have branched to 
another TESTRAN statement. The 
other statement was in an overlay 
segment not currently in main stor- 
age. 


System Action: No branch occurred. 
The next sequential statement was 
executed. 


User Response: If the job step is 
to be executed again, check the 
branch address, which is specified 


by the fifth operand of the TEST ON 
statement. Ensure that the control 
section containing the address will 
be in main storage when the TEST ON 
statement is executed. 


IEGI23 


ITEGI24 


IEGI25 


- counter with a TEST DEFINE 


‘DUMP' TRUNCATED AT 65K BYTES 

Explanation: During execution of 
the TESTRAN interpreter, a DUMP 
DATA or DUMP CHANGES statement 
specified dumping of a storage area 
containing more than 65,535 bytes. 


System Action: Only the first 
65,535 bytes of the specified area 


were dumped. 


If the job step is 
again, check the 
starting and ending addresses for 
the dump; these are specified by 
the second and third positional 
operands. Ensure that the differ- 
ence between the addresses will not 
exceed 65,535 bytes when the pro- 
gram is loaded. If the program is 
scatter loaded, both addresses must 
be in the same control section. 


User Response: 
to be executed 


INACTIVE COUNTER 


Explanation: During execution of 
the TESTRAN interpreter, a SET 
COUNTER or TEST ON statement 


referred to a TESTRAN counter in an 
overlay segment not currently in 
storage. 


The statement was 


System Action: 
ignored. 


User Response: If the job step is 
to be executed again, define the 
State- 
ment that will be in storage when 
the counter is referred to. 


INVALID DATA LENGTH 


Explanation: During execution of 
the TESTRAN interpreter, the second 
and fourth operands of a TEST WHEN 
statement specified the location of 
data in registers or main storage. 
Both the type and length attributes 
of this data were specified by a 
DATAM operand. The data length 
exceeded the limit for the data 


type. 
System Action: The statement was 
ignored. The next sequential 


statement was executed. 


User Response: If the job step is 
to be executed again, correct the 


DATAM operand by specifying a data 
length and type that are consis- 
tent. 
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INVALID ‘DUMP* ADDRESS 


4 


Explanation: During execution of 
the TESTRAN interpreter, a DUMP 
DATA or DUMP CHANGES statement 
specified a starting or ending 


address that was higher than the 
highest address in main storage. 


The statement was 


System Action: 
ignored. 


User Response: 


to be executed again, make sure 
that the second or third operand of 
the DUMP DATA or DUMP CHANGES 


statement was specified correctly 
and was not incorrectly modified. 
Also check the contents of any 
registers referred to in the oper- 
and. 


INVALID "WHEN' BRANCH ADDRESS 
Explanation: During execution of 
the TESTRAN interpreter, a TEST 
WHEN statement should have branched 
to another TESTRAN statement. The 
other statement was not in an open 
control section. 


System Action: No branch occurred. 
The next sequential statement was 
executed. 


User Response: If the job step is 
to be executed again, check this 


branch address, which is specified 
by the last positional operand of 
the TEST WHEN statement. Ensure 
that the control section containing 
the address will be open when the 
TEST WHEN statement is executed. 


INACTIVE "‘WHEN* BRANCH ADDRESS 

Explanation: During execution of 
the TESTRAN interpreter, a TEST 
WHEN statement should have branched 
to another TESTRAN statement. The 
other statement was in an overlay 


segment not currently in storage. 


System Action: No branch occurred. 
The next sequential statement was 
executed. 


User Responses If the job step is 
to be executed again, check the 


branch address, which is specified 
by the last positional operand of 
the TEST WHEN statement. Ensure 
that the control section containing 
the address will be in main storage 
when the TEST WHEN statement is 
executed. 


If the job step is 
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INVALID SIGN ON DECIMAL FIELD 


Explanation: During execution of 
the TESTRAN interpreter, the second 
or fourth positional operand of a 
TEST WHEN statement specified the 
address of a decimal value. The 
Sign position of the decimal value 
contained an invalid bit configu- 
ration. 


System Action: The TEST WHEN state- 
ment waS ignored. The next sequen- 
tial statement was executed. 


User Response: If the job step is 
to be executed again, correct the 


Sign in the rightmost byte of the 
decimal value. 


ADDR1 GREATER THAN ADDR2 


Explanation: During execution of 
the TESTRAN interpreter, a DUMP 
DATA, DUMP CHANGES, TRACE REFER, 


or TRACE CALL statement 
starting address that 
address 


TRACE FLOW, 
Specified a 
was higher than the ending 
for the dump or trace. 


System Action: The dump or trace 
was restricted to the single byte 
at the starting address. 


If the job step is 
to be executed again, make sure 
that the second or third operand 
was specified correctly and was not 
incorrectly modified. Also check 
the contents of any registers 
referred to in the operand. If the 
program is scatter loaded, both 
operands should specify addresses 
in the same control section. 


User Response: 


TRACE TABLE FULL AT xxx 


execution of 
TRACE 


Explanation: During 
the TESTRAN interpreter, a 


CALL, TRACE FLOW, or TRACE REFER 
Statement waS executed when ten 
traces were already active. 


XXx is the 
of the 


In the message text, 
address in hexadecimal 
statement. 


System Action: A new trace was 
Started, as specified by the state- 


ment. However, the tenth trace, 
the one that had been most recently 
started, was suspended. 
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User Response: If the job step is 
to be executed again, change the 


testing logic so that no more than 
ten traces are active at one time. 


DEB UNAVAILABLE 


Explanation: During execution of 
the TESTRAN interpreter, the second 
operand of a DUMP TABLE statement 
specified dumping of a data extent 
block (DEB). The associated data 
control block (DCB), specified by 
the third operand, was not current- 
ly open. 


DUMP TABLE 


System Action: The 
statement was ignored. 


User Response: If the job step is 
to be executed again, make sure 


that the data control block will be 
open when the DUMP TABLE statement 
is executed. 


ILLEGAL "TEST AT" DELETED FROM--xxx 
Explanation: During execution of 
the TESTRAN interpreter, control 


was to be returned to the problem 
program at an address specified by 
a TEST AT statement. At the return 
address was a TESTRAN supervisor 
call (Svc) instruction that dis- 
placed either another supervisor 
call instruction or a privileged 
instruction. Before control was 
returned, the original instruction 
was replaced in the problem pro- 
gram. 


In the message text, xxx is the 
return address in hexadecimal in 
the problem program. 


System Action: If the original 
instruction was a privileged 
instruction, its execution caused 


abnormal termination of the task. 


If it was a supervisor call 
instruction, it was executed nor- 
mally and remained in the problem 
program until the TESTRAN inter- 
preter received control from a 
supervisor call instruction insert- 
ed at some other address. Then, 
the original supervisor call 
instruction was again displaced by 
a TESTRAN supervisor call instruc- 
tion. 
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User Response: If the original 
instruction was privileged, change 


the TEST AT statement so that it 
inserts the supervisor call 
instruction at another address. 


Then execute the job step again. 


If the original instruction was a 
supervisor call instruction and if 
the job step is to be executed 
again, allow for the temporary dis- 
placement of the TESTRAN supervisor 
call instruction, or rewrite the 
TEST AT statement. 


PROGRAM CHECK DURING ‘GO BACK! -- 


INSTRUCTION AT xxx 


Explanation: During execution of 
the TESTRAN interpreter, control 


was to be returned to the problem 
program after execution of an 
instruction that was displaced by 
insertion of a TESTRAN supervisor 
call (SVC) instruction. Execution 
of the displaced instruction caused 
a program interruption. 


In the message text, xxx is the 
address in hexadecimal of the TES- 
TRAN supervisor call instruction. 


System Action: The standard system 
exit routine, or the routine speci- 
fied by a SPIE macro-instruction, 
was given control. 


User Response: Correct the instruc- 


tion causing the program interrup- 
tion and execute the job step 
again. 

INACTIVE FLAG 

Explanation: During execution of 


the TESTRAN interpreter, a SET FLAG | 
or TEST WHEN statement referred to 
a TESTRAN flag contained in an 
overlay segment not currently in 
main storage. 


System Action: The statement was 
ignored. 

User Response: If the job step is 
to be executed again, define the 
flag with a TEST DEFINE statement 


that will be in storage when the 
flag is referred to. 
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UNDEFINED FLAG 


Explanation: During execution of 
the TESTRAN interpreter, a SET FLAG 
or TEST WHEN statement referred to 
a TESTRAN flag not contained in an 
open TESTRAN control section. 


The statement was 


System Action: 
ignored. 


User Response: If the job step is 
to be executed again, define the 


flag with a TEST DEFINE statement 
in a control section that will be 
open when the flag is referred to. 


INVALID "TRACE STOP" ENTRY AT xxx 

Explanation: During execution of 
the TESTRAN interpreter, the second 
operand of a TRACE STOP statement 


specified an address or sublist of 
addresses. One of these addresses 
was not the address of a TRACE 
statement and was, therefore, 
invalid. 

In the message text, xxx is the 


invalid address in hexadecimal. 


System Action: The invalid address 
was ignored. If the operand was a 
sublist, all traces corresponding 
to valid addresses were stopped. 


User Response: If the job step is 
to be executed again, correct the 


invalid address. 


‘TRACE' STOPPED BY OVERLAY AT xxx 

Explanation: During execution of 
the TESTRAN interpreter, the prob- 
lem program loaded an overlay seg- 
ment that overlaid all the TRACE 


Statements for active traces. 


In the message text, xxx is the 
address in hexadecimal of the 
instruction that caused the load- 
ing. 

System Action: All traces were 
stopped. They were not automat- 
ically restarted when the segment 


containing the TRACE statements was 
reloaded. 


User Response: If the job step is 
to be executed again, change the 


program so that the TRACE state- 
ments are not overlaid or be pre- 
pared to restart any traces that 
will be overlaid but will be 
required subsequently. 
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PROGRAM CHECK DURING 
INSTRUCTION AT xxx 


‘TRACES -- 


Explanation: During execution of 
the TESTRAN interpreter, a program 
interruption occurred during a 


trace of the problem program. 


text, xxx is the 
hexadecimal of the 
that caused the inter- 


In the message 
address in 
instruction 
ruption. 


System Action: The standard system 
exit routine, or the routine speci- 
fied by a SPIE macro-instruction, 
was given control. Active traces 
were not suspended. 


User Response: If the job step is 
to be executed again, correct the 


instruction causing the program 
interruption. 
"TRACES STOPPED BY SVC AT xxx 


During execution of 
the TESTRAN interpreter, a LINK, 
XCTL, or RETURN macro-instruction 
was executed during a trace of the 
problem program. 


Explanation: 


In the. message text, xxx is the 
address in hexadecimal of the 
supervisor call (SVC) instruction 


in the macro-expansion. 


System Action: All traces were 
stopped. They were not automat- 
ically restarted when control was 
returned to the problem program. 


User Response: If the job step is 
to be executed again, restart any 


traces that were stopped, but are 
required, upon return to the prob- 
lem program. 


FLOATING POINT REGISTER SELECTED 
NO FLOATING POINT HARDWARE 
JOB ABORTED 


Explanation: During execution of 
the TESTRAN interpreter, a TESTRAN 
statement referred to a floating 
point register, but the computing 
system did not include the floating 
point option. 


System Action: The task was termi- 
nated abnormally. 


TESTRAN 
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User Response: Either remove all 
references to floating point reg- 
isters, and execute the job step 


again, or execute the job step ona 
computing system with the floating 
point option. 


MACRO-EXPANSION MESSAGES 


TEST HAS NOT BEEN OPENED 


Explanation: A TESTRAN statement 
precedes the first valid TEST OPEN 
statement. 


System Action: The statement was 


deleted. Severity code = 8. 
User Response: Precede the state- 


ment with a valid TEST OPEN state- 
ment. 


NAME NOT SPECIFIED 


A TEST OPEN statement 
symbol in its 


Explanation: 
does not contain a 


name field. 


statement was 
12. 


System Action: The 
deleted. Severity code = 


User Response: Provide the required 
symbolic name. 


ENTRY POINT NOT SPECIFIED 


Explanation: The second positional 
operand (problem program entry 
point) was omitted from a TEST OPEN 
statement. 


statement was 
Severity code 


System Action: The 
processed normally. 
= *, 


User Response: No response is 
required if the TEST OPEN statement 


never receives control directly, 
but instead is referred to ky the 
OPTEST operand of another TEST OPEN 
statement. If the TEST OPEN state- 
ment does receive control directly, 
the omitted operand should be sup- 
plied. 


LEGMO4 
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THIS MACRO ESTABLISHES CSECT xxx 


Explanation: A TEST OPEN statement, 
named xxx, initiates assembly of a 
control section with the same name. 
This control section will contain 
all suksequent TESTRAN statements 
until the next TEST OPEN macro- 
instruction initiates a new control 
section. 


System Action: The statement was 
processed normally. Severity code 


= * 


xxx NOT A VALID OPERAND FOR yyy 


Explanation: The first operand of a 
TESTRAN statement iS xxx. This 
operand is not valid following the 
operation field yyy. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Correct the first 


operand. 


XXX yyy ADDRESS NOT SPECIFIED 


Explanation: A required address 
operand was omitted from a TESTRAN 


statement whose operation field. is 
xxx and whose first operand is yyy. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Provide the required 
address operand. 


THIS TEST DEFINE xxx HAS NO xxxS 


Explanation: The third positional 
operand (flag or counter sublist) 
was omitted from a TEST DEFINE 
statement. The second positional 
operand, xxx, is either COUNTER or 
FLAG. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Provide the required 
sublist of flag or counter names. 


xxx NOT A VALID TEST DEFINE OPERAND 


Explanation: The second positional 
Operand of a TEST DEFINE statement 
is xxx. This operand is invalid. 
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System Action: The statement was 
deleted. Severity code = 8. 


User Response: Correct the second 
operand. It must be either COUNTER 
or FLAG. 


MACRO NUMBER xxx IN yyy 


Explanation: An identification nun- 
ber, XXX, WaS asSigned to a TESTRAN 
statement. This statement is in a 
control section named yyy, which is 
the nane of the preceding TEST OPEN 
statement. 


statement was 
Severity code 


System Action: The 
processed normally. 
= *, 


User Response: Keep the assembler 
source and object program listing 
for comparison with the listing of 
TESTRAN edited output. The state- 
ment identification number, which 
appears in both listings, identifi- 
es all output produced by the 
statement. 


SELECT CODE INVALID AND IGNORED 


Explanation: The SELECT operand of 
a TESTRAN statement does not speci- 
fy a valid TESTRAN output class. 


System Action: The statement was 
processed, but the invalid operand 
was ignored. Severity code = 4. 


User Response: Specify a valid out- 
put class number (an integer from 1 
to 8), or compensate for the error 
by changing the PARM parameter of 
the EXEC statement for the TESTRAN 
editor. 


xxx NOT A VALID OPERATOR 


Explanation: The third positional 
operand of a TEST WHEN statement is 
XXX. This operand is not a valid 
logical or relational operator. 


System Action: The statement was 
deleted. Severity code = 8. 


_. User Response: Specify a valid log- 
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ical operator (AND or OR) or rela- 
tional operator (LT, LE, EQ, NE, 
GT, or GE). 
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INVALID LITERAL TYPE CODE 


Explanation: An operand of a TES- 
TRAN statement is a literal in 
which the type code is either 
absent or invalid. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Correct the operand 
by specifying a valid type coce 
following the equal sign (=) of the 
literal. 


BOTH xxx AND yyy CANNOT BE LITERALS 


Explanation: The second and fourth 


positional operands of a TEST WHEN 
statement are xxx and yyy, respec- 
tively. Both are literals. 


Because the arithmetic relationship 
between two literals is constant, a 
test of this relationship would be 
meaningless. 


System Action: The statement was 


deleted. Severity code = 8. 

User Response: Replace one literal 
with pointer to a main storage 
location, a register, or a TESTRAN 


counter. 


DATAM IGNORED ON THIS FORM OF TEST 
WHEN 


DATAM operand 
appears in a TEST WHEN statement 
that tests the condition of a TES- 
TRAN flag, or a relationship 
between TESTRAN flags. The operand 
is invalid in this context. 


Explanation: A 


System Action: The statement was 
processed, but the invalid operand 
waS ignored. Severity code = 4. 


User Response: Omit the DATAM 
operand, or rewrite the statement 
to test a relationship between 
arithmetic variables. 


FORMAT UNKNOWN. 1 BYTE HEX ASSUMED 
Explanation: In a SET VARIABLF or 
TEST WHEN statement, two operands 
specify the location of data, which 
is in registers or main storage. 
The attributes of this data are not 
defined in the symbol table nor are 
they specified by a DATAM operand. 
The data is, therefore, assumed to 
be hexadecimal with a length of one 
byte. 


IEGM19 


LEGM20 


IEGM31 


statement was 
Severity code 


System Action: The 
processed normally. 
= *, 


User Response: If a 1i-byte hexa- 
decimal format is not intended, 


provide a DATAM operand that speci- 
fies the correct attributes. 


TEST WHEN WRITTEN IMPROPERLY 


Explanation: The format of a TEST 
WHEN statement is invalid. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Correct the error in 
the format. 


NO RIGHT PAREN IN OPERAND xxx 


Explanation: A positional operand 
of a TESTRAN statement is an expli- 
cit or indexed implied address. In 
this operand, the right parenthesis 
was omitted. The position of the 
operand in the operand field is 
XXX. 


The statement was 
right parenthesis 
present. Sever- 


System Action: 
processed; the 


was assumed to be 
ity code = 4. 


User Response: Check the source and 
object program listing to determine 
if assumption of the parenthesis 
resulted in correct processing of 
the statement. Rewrite the operand 
if the processing was not correct. 


COMMENT IS INVALID 


Explanation: In a DUMP COMMENT 
statement, the second positional 
operand (a progranmer-written 
comment) either was omitted or is 
invalid. If invalid, the operand 
either is shorter than three char- 
acters (including delimiting 
apostrophes), or does not contain 
one or both of the required apos- 
trophes. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Specify or correct 


the comment operand. 
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xxx NOT A VALID TABLE TYPE 


Explanation: The second positional 
operand of a DUMP TABLE statement 
is xxx. This operand is invalid. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Correct the second 
operand. It must be DCB, DEB, or 
TCB. 


INVALID REGISTER NOTATION 


Explanation: The second positional 
operand (a register sublist) of a 
DUMP PANEL statement contains 
invalid register notation. 


System Action: The statement was 
processed; the invalid operand was 
ignored and dumping of all reg- 
isters was assumed. Severity code 
= 4, 


User Response: No response is nec- 


essary. 


INVALID TYPE CODE IN xxx 


Explanation: The operand DATAM=xxx 
contains an invalid type code. 


System Action: The statement was 
processed, but the invalid operand 
was ignored. Severity code = 4. 


User Response: 


Correct the DATAM 
operand. - 


A REQUIRED ADDRESS NOT SPECIFIED 


Explanation: This message occurred 
for either of two reasons: 


e The second positional 
(the starting address for a 
trace) was omitted from a TRACE 
CALL, TRACE FLOW, or TRACE REFER 
statement. 


operand 


e The third positional operand (the 
ending address for a trace) was 
omitted from a TRACE CALL state- 
ment. 

System Action: The statement was 

deleted. Severity code = 8. 


User Response: Provide the 


required address operand. 
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THIS TRACE STOP STOPS ALL TRACES 


Explanation: The optional second 
positional operand (trace sublist) 


was omitted from a TRACE STOP 
statement. This statement will, 
therefore, stop all active traces. 
System Action: The statement was 
processed normally. Severity code 
= *, 

User _ Response: If all traces 


should not be stopped, provide the 
optional trace sublist operand to 
specify only those traces that are 
to be stopped. 


COMMENT IS INVALID AND IGNORED 


The COMMENT operand 
of a TRACE statement is invalid. 
The operand either is shorter than 
three characters (including delim- 
iting apostrophes), or does not 
contain one or both of the required 
apostrophes. 


Explanation: 


System Action: The statement was 
processed, but the invalid operand 
was ignored. Severity code = 4. 
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User Response: Correct the COMMENT 


operand. 


2ND AND 3RD OPERANDS MUST BE 
PRESENT 


required 
were omitted 


Explanation: One or more 
positional operands 


from a SET statement. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Provide the 


required operand or operands. 


SET FLAG CONDITION MUST BE =0 or =1 


The third positional 
of a SET FLAG 


Explanation: 
Operand (condition) 


statement is invalid. 


System Action: The statement was 
deleted. Severity code = 8. 


User Response: Write the third 
Operand as =0 or =1, or as the 
symbolic name of a TESTRAN flag. 


Address 
as an external reference 30 
assembled as a constant 19,71 
declared in a USING statement 
explicit 30,71 
indexed 17,27,64,71 
test point 15,67 
Ampersand 29,71 
Apostrophe 29,71 
Area 
(see storage area) 
ASM (job step) 35,41,45,48.1,73,74 
ASMEC and ASMFC (cataloged procedures) 
definition 73 
use 35 
Assembler 
E- or F-level assembler program 35 
listing 9,49 
options 36,41,45,48.2 
processing of TESTRAN 
macro-instructions 12 
symbol tables 24 
use with TESTRAN 11 
Assembly 
job control statements for 
35,41,44,48.1 
listing 8,9,30 
of address operands 19,71 
of problem program and TESTRAN 
Assignment functions 13,70 
(see also SET statements) 
Asynchronous exit routines 27 
Attributes 23,64,65,69,70 


19,30 


11,30 


Base address 
for addressing dummy control sections 
19,28 . 
for addressing other object modules 30 
Blank common control section 24 
Branch 
by a TESTRAN statement 
tracing of 26,64 
Branching functions 13,69 
(see also TESTRAN subroutines) 


12,66,68,69 


Call library 38,44,48,48.5 
CALL macro-instruction 25,26,32,64 
Cataloged procedures (IBM-supplied) 
definitions 73,74 
use 35,36,39,41,44,48.1 
Chained opening 
definition 67 


examples 32,33 
Change dump 17,64 
Changes 


in index values 17 
to a dummy control section 19 
to a storage area 16,64 
Class (of test information) 
definition by a SELECT operand 
29, 33,65, 67 


INDEX 


identification in a TESTRAN listing 
53-61 
selection for printing 
Class identification number 
in a job control statement 40,48.4 
in a SELECT operand 29,65,67 
in a TESTRAN listing 53-61 
Class number 
(see class identification number) 
Coding conventions 63 
Commas 63 
COMMENT operand 
description 71 
example 29 
function 65 
Comments 
in the comments field 12 
in the operand field 29 
Common control section 24 
Completion 
of testing 31 
of a timer interval 28 
Condition 
condition code 26,55,59 
condition testing 11,34.2,68 
error conditions 8,34.7 
Conditional branching 68 
Constants 12 
Control block 20-22,64,65 
Control dictionary 
handling by the linkage editor 
38,44,47,48.5 
inclusion in a load module 
12,37,42,46,48.2 
production by the assembler 12 
Control flow 
changing of 34.7 
tracing of 25 
Control information 
recorded by the TESTRAN interpreter 11 
used by the TESTRAN editor 12 
(see also symbol tables) 
Control sections 
defined by TEST OPEN (see TESTRAN 
control section) 
map of 20 
replaced by the linkage editor 
31, 38,43,47,48.5 
Conventions 
for coding TESTRAN statements 63 
for describing TESTRAN statements 71 
Count 
line count for assembly listing 
36,41,45,50 
page count for TESTRAN listing 
40,48.4,67 
Counter 
(see TESTRAN counter) 


40,48.4 


Data control block 21,22,64,65 
Data extent block 21,22,64,65 
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Data set 
(see TESTRAN data set) 
Data types 
printing formats 51 
specification 71 
DATAM operand 
description 71 
examples 23,34.6,34.7 
function 65,69,70 
DCB 
Macro-instruction 20,28 
operand 20,21,65,71 
(see also data control block) 
DDN operand 
description 71 


example 34.1 
function 66 

DEB 
operand 20,21,65,71 


(see also data extent block) 
Decision-making functions 13,68 

(see also condition testing) 
Default 

assembler options 

printing format 24 
Dictionary 


41,45,48.2 


(see control dictionary; external symbol 


dictionary) 
Displacement 30,71 
DSECT operand 
description 71 
examples 18,19,28 
function 65 
Dummy control section 
addressing of 28 
describing another module 30 
dumping changes to 19 
dumping of 17 
tracing references to 28 
Dump 
definition 11 
examples 15,16, 19-21,29 
formats 53-56 
DUMP statements 
examples 
DUMP CHANGES 16,23 
DUMP COMMENT 29,34.7 
DUMP DATA 15,18,23,30 
DUMP MAP 20 
DUMP PANEL 20-23 
DUMP TABLE 20 
formats 71 
functions 64 
Dynamic parallel program 34.1 
Dynamic serial program 34 


EDIT (job step) 
Editing 
linkage editing 
TESTRAN editing 
END statement 14-34 
Entry point 
in an END statement 14,15 
in an ENTRY statement 31 
in a TEST OPEN statement 
Entry point register 66 


40,48.1,74 


11,12,36,41,44,48.1 
11,12,39,48.1 


15,66 
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ENTRY statement 
assembler 33 
linkage editor 31 


Error 
detected by the TESTRAN interpreter 
49,56 
diagnostic message 56,62,75-88 
recovery 8,34.7 
ETXR operand 28 
Execution, job control statements for 


38,44,48.1 
Exit routine 27 

Exponent 51 
External reference 30,33 
External symbol 30,64,69,70 
External symbol dictionary 30 
EXTRN statement 33 


Field 
(see operand field; 
Flag 
(see TESTRAN flag) 
Format 
printing format 
control of 22,31 
of data types 51 
of a TESTRAN listing 49 
statement format 71 


storage field) 


GO 
job step 45,48.1,74 
load module 20,38,44,47,73,74 
GO statements 
examples 
GO BACK 34.2,34.7 
GO IN 34.8 
GO OUT 34.8 
GO TO 17 
formats 71 
functions 69 


Hexadecimal 
as a default format 31,69 
as an implied data type 23 


Implicit control section 29,31 

(see also TESTRAN control section) 
Indexed addresses 19,27,64,71 
Interpretive execution 26,27 


Job control statements, writing of 35 
Job library 39,45,48.1 


Keyword operands 63 


Length attribute 
of a symbol 64 
specified by a DATAM operand 
23, 34.6,34.7,65,69-71 
Library 
(see call library; job library; 
procedure library) 
Limits on traces 27 
Linkage editing 
job control statements for 
36,41,44,48.1 
of problem program with TESTRAN 
11, 31,33 


Linkage functions 12,66 


Listing 

(see,.assembly listing; TESTRAN listing) 
Literal’ 68-71 
LKED 


cataloged procedure 37,73 
job step 37,41,45,48.1,73,74 


MACRO ID 
in an assembly listing (see MACRO 
NUMBER) 
in.a TESTRAN listing 
MACRO NUMBER 86 
Macro-instruction 
ATTACH 28,34 
CALL 25,26,32,64 
DCB 20,28 
GET, PUTX 28 
IDENTIFY, LINK, LOAD, XCTL 34 
OPEN 20 
RETURN 8,9 
SAVE 8,9,15-20,25, 28 
SPIE, STIMER 28 
TESTRAN 12 
(see also TESTRAN statements) 
MAXE operand 66,67 
Maximum number 
of dummy control section formats 65 
of executed TESTRAN statements 67 
of internal subroutine levels 69 
of pages in a TESTRAN listing 
40,48.4,67 
of traces 27 
MAXP operand 66,67 
Messages 56,62,75 


49-61 


NAME operand 
description 71 
examples 23 
function 65 


Opening of a TESTRAN control section 
Operand field 63 
Operation code 
of a dumped instruction 24,51 
of a TESTRAN statement 12 
OPTEST operand 
description 71 


66,67 


examples 32,33 
function 67 

Options 
assembler 36,41,45,48.2 


linkage editor 37,42,46,48.2 
TESTRAN editor 40,48.1 
(see also task options) 
Output identification 
printing of 52 
specification of 66 
Overlay program 33 


PARM parameter 35-48.4 
Positional operands 63 
Printing format 
control of 22,31 
of data types 51 
of a TESTRAN listing 49 
Procedure library 35 
Program status word, dumping of 20 


PSW 
(see program status word) 
Recording functions 12,14,64 
Reference 
external reference 30,33 
reference between overlay segments 33 
tracing of references 25 
REFR option 37,42,46,48.3 
Region size 
for linkage editor 37,41,45,48.1 
for problem program 45,48.1 
Registers 
dumping of 20 
specification in TESTRAN statements 71 
RENT option 37,42,46,48.3 
Reprocessing 
of a load module 31,38,43,47,48.5 
of a TESTRAN data set 29 
Return of control 15,17,34,53,66,69 
REUS option 37,42,46,48.3 
Reusability 34 
(see also RENT option; REUS option) 


Scale attribute 23,52,69-71 
Scatter loading 27 
Segment 33,34 
SELECT operand 
description 71 
examples 29,30,33 
function 65,67 
Selective retrieval 
classification of information for 29,33 
selection of classified information 
40,48.4 
SET statements 
examples 
SET COUNTER 34.3 
SET FLAG 34.4,34.5 
_ SET VARIABLE 34.7 
formats 70 
functions 71 
SIZE option 37,42,46,48.3 
Speed 
of the TESTRAN editor 40,48.3 
of the TESTRAN interpreter 66 
Storage area 
allocated 22,24,27,54 
defined by indexed addresses 17 
described by a dummy control section 
17,19 
described by a symbol table 24 
dumping changes to 16 
dumping of 14 
length of 64,65 
specification of 64 
tracing references to 25 
Storage field 
defined by a DATAM operand 23,31,65 
defined by a DS or DC statement 24 
Storage map, dumping of 20 
Storage requirements 
of the TESTRAN editor 40,48.3 
of the TESTRAN interpreter 66 
Sublist 63 
Subroutine call 
by a GO IN statement 69 
tracing of 26,64 


70,71 
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Supervisor call 
supervisor call instruction 
tracing of 26,64 
SVC instruction 
(see supervisor call instruction) 
Symbol tables 
-handling by the linkage editor 
12,31,37,38,42,43,46,47,48.2,48.4 
production by the assembler 
12,35,41,45,48.2 
use by the TESTRAN editor 
SYNAD operand 28 
System output 49 
System table 
(see control block) 


54,67 


12,24 


Task control block 
Task options 66,71 
TASME (cataloged procedure) 
definition 73 . 
use 41 . 
TASMEG (cataloged procedure) 
definition 74 
use 44 
TASMEGED (cataloged procedure) 
definition 74 
use 48.1 
TCB 
operand 20,21,65,71 
(see also task control block) 
Test information 
classification for selective retrieval 
29,33 
recording and printing of 11 
selective retrieval of 40,48.4 
TEST option 


21, 22,65 


assembler 36,41,45,48.2 
linkage editor 37,42,46,48.2 
Test point 


definition of 15 
identification of 49,52 
specification of 67 
SVC instruction at 54 
TEST statements 
examples 
TEST AT 14,30,33 
TEST CLOSE 34 
TEST DEFINE 34.3-34.5 
TEST ON 34.2,34.3 
TEST OPEN 15, 29,32,33,34.1 
TEST WHEN 34.4-34.7 
formats 71 
functions 66-68 
TESTRAN control section 
chained opening by OPTEST 32,33,67 
closing by TEST CLOSE 34,66 
definition by TEST OPEN 66,85 
insertion in overlay segments 33 
replacement by the linkage editor 
31,38,43,47,48.5 
TESTRAN counter 
definition of 66,67 
setting of 34.1,34.3,70 
testing of 34.2,34.3,68 
TESTRAN data set 
creation by the TESTRAN interpreter 11 


92 


definition by a SYSTEST DD statement 
34.1,39,48,48.1,48.6 
processing by the TESTRAN editor 
29,40,48.3,48.7 
TESTRAN editing, job control statements 
for 39,48.1 
TESTRAN editor 
definition 11 
listing (see TESTRAN listing) 
storage requirements 40,48.4 
TESTRAN flag 
definition of 66,67 
setting of 34.1,34.4,34.5,70 
testing of 34.4,34.5,68 
TESTRAN interpreter 
control of 
definition 11 
linkage to 12,15,66 
TESTRAN listing 
commenting the listing 29 
example of 9,49 
interpretation of 49 
maximum page count 40,48.4,67 
TESTRAN macro-instructions 12 
(see also TESTRAN statements) 
TESTRAN messages 75 
TESTRAN output 
(see TESTRAN listing) 
TESTRAN services 
description 8 


requests for 11,12 


TESTRAN statement trace 49,62 
TESTRAN statements 

examples of 14-34.9 

execution of 12,15 

functions 12,63 

output of 52-62 

structure and format 12,71 
TESTRAN subroutines 34.8,69 
Trace 

definition 11 

examples 26 
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shifting a trace 27,28 


starting a trace 25 
stopping and restarting a trace 
25-27, 34,34.1 
Trace area 
identification of 59,60 
limitation of 27 
specification of 64 
TRACE statements 
examples 25-29 
formats 71 
functions 64 
TTED (cataloged procedure) 
definition 74 
use 39 
Type attribute 
of a symbol 64 
specified by a DATAM operand 
23, 34.6,65, 69-71 
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